Carrier Lookup API:

Would you like to perform a carrier lookup by phone number? Now you can. The Club Texting Carrier Lookup API service allows you to automatically determine the carrier of any mobile number. To use this service, please contact us, specifying your need for the Carrier Lookup Service. We will create a separate lookup account on your behalf. Our system will keep track of how many numbers were looked up and each lookup is billed at 1 cent.


Return To Our Complete API Documentation Center

A request for a page using the structure shown below is all that is needed for you to lookup the carrier of a mobile number using the Club Texting Network Lookup Service. The endpoints for these HTTP requests are https://app.clubtexting.com/USlookup.php for HTTP and
https://app.clubtexting.com/USlookup.php for HTTPS (SSL).

HTTP/1.1 is enabled so, if sending multiple packets, the TCP/IP connection should be kept open between requests. Requests should be sent as a HTTP GET using the parameters listed below.

Example of Carrier Lookup API Usage:

< ? php
$ch = curl_init(“https://app.clubtexting.com/USlookup.php”);
curl_setopt($ch, CURLOPT_GET, 1);
curl_setopt($ch, CURLOPT_GETFIELDS, “user=myusername&pass=mypassword&phonenumber=2345678901");
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
$data = curl_exec($ch);
print($data); /* result of API call*/
?>

Parameters for requests

Parameters (may be passed via GET and values must be properly URL encoded)

Several parameters are common to all message types, and should be included in the HTTP request regardless of the specific method being invoked. Note that the user, pass and phonenumber parameters are required. Details of these parameters are as follows:

user
Username of the account to send through
pass
Password
phonenumber MSISDN of the message recipient (eg 2345678901). No leading "+" or “1” is required

The following example shows the HTTP request that is understood by the Club Texting Network Lookup Service:
https://app.clubtexting.com/USlookup.php?user=myusername&pass=mypassword&phonenumber=2345678901

Parsing simple text response (default response)

The meaning of the response received is:

Value
Description
<network>
Carrier that the mobile number belongs to. See Carrier Codes for possible values.
UNKNOWN Unrecognized carrier. Please contact us to extend coverage.
FAILURE Lookup Failed Due to Inaccurate Mobile Number

Provider name is returned if lookup is successful. If it is not successful, a number is returned by the script as displayed in the table below. Where the following table contains explanations of certainty codes


Certainty Value
Description
   -1
Invalid Username or Password
   -2
Invalid Phone Number Format
   -3
Insufficient Credits
   -4
Lookup Error. The customer should wait a few seconds and reattempt their lookup.


Comprehensive List of US Providers
Sprint
SPRINTUS
Verizon
VERIZONUS
Cingular
CINGULARUS
Tmobile
TMOBILEUS
Nextel
NEXTELUS
Arch Wireless
ARCHWIRELESSUS
Cellcom
CELLCOMUS
Western Wireless
WESTERNWUS
AllTel
ALLTELUS
Cellular One
CELLULARONEUS
Dobson Cellular
DOBSONUS
Cricket Wireless
CRICKETUS
MetroPCS
METROPCSUS
Metrocall Wireless
METROCALLUS
suncom
SUNCOMUS
US Cellular
USCELLULARUS
boost
BOOSTUS
ATT
ATTUS
Cellular South
CELLULARSOUTHUS
Virgin
VIRGINUS
Iowa Wireless
IOWAWIRELESSUS
Midwest Wireless
MIDWESTUS
Centennial Wireless
CENTENNIALUS
Cincinnati Bell?
CINBELLUS
Alaskan Communications 
ACSUS
Edge Wireless
EDGEUS
Rural Cellular
RURALCELUS
QWest/Sprint
QWESTUS
Ntelos
VIRGINIAPCSUS
Amerilink
CHOICEUS
Central Wireless
CENTRALUS
Triton PCS
TRITONPCSUS
Southern Bell
SOUTHWESTBELLUS
Pacific Bell    
PACBELLUS
North Coast PCS
NORTHCOASTUS


Comprehensive List of Canadian Providers
Fido
FIDOCA
Bell Mobility
BELLCA
Telus  
TELUSCA
SaskTel
SASKTELCA
Virgin Canada
VIRGINCA
MTS Canada
MTSCA
Rogers
ROGERSCA


CUSTOMER LOGIN


LIVE SALES & SUPPORT


(Monday to Friday, 9am - 7pm EST)

CLUB TEXTING CLIENTS

Our Text Messaging Clients


CERTIFICATIONS

Member Of The Mobile Marketing Association

Click