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.
Carrier information, including ported numbers, is updated in real time. The data our lookup service returns is the same data the carriers rely upon to route messages in and our of their own networks.
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 is https://app.clubtexting.com/api/lookup 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/api/lookup”);
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*/
?>
Code Samples For The Carrier Lookup In Other Languages
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:
Username of the account to send through 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/api/lookup?user=myusername&pass=mypassword&phonenumber=2345678901Parsing simple text response (default response)
The meaning of the response received is:
Description 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
Description Invalid Username or Password Invalid Phone Number Format Insufficient Credits Lookup Error. The customer should wait a few seconds and reattempt their lookup.
Comprehensive List of US Providers
ACS Wireless ACSUS Alltel ALLTELUS RINA/All West Wireless ALLWESTUS EKN/Appalachian Wireless APPALACHIANUS Arch Wireless ARCHWIRELESSUS AT&T Wireless ATTUS Bluegrass Cellular BLUEGRASSUS Boost USA BOOSTUS Cellcom CELLCOMUS Cellular South CELLULARSOUTHUS Centennial CENTENNIALUS Central Wireless CENTRALUS Amerilink CHOICEUS Cincinnati Bell CINBELLUS Cingular Wireless CINGULARUS Cox Communications COXUS Cricket Communications CRICKETUS RINA/CTC Telecom-Cambridge CTCUS Dobson DOBSONUS RINA/Snake River PCS EAGLEUS ECIT - Cell One of East Central IL ECITUS Edge Wireless EDGEUS RINA/FMTC-Farmers Mutual Telephone Co. FARMERSMUTUALUS GCI Communications GENERALCOMUS RINA/Silverstar GOLDSTARUS Immix Wireless/PC Management IMMIXUS Inland Cellular INLANDUS Iowa Wireless IOWAWIRELESSUS Illinois Valley Cellular IVCUS Metrocall Wireless METROCALLUS Metro PCS METROPCSUS Midwest Wireless MIDWESTUS Nex-Tech Wireless NEXTECHUS Nextel Communications NEXTELUS North Coast PCS NORTHCOASTUS nTelos NTELOSUS RINA/Nucla-Naturita Telephone Co. NUCLANATURITAUS Pacific Bell PACBELLUS Revol REVOLUS RCC/Unicel RURALCELUS RINA/South Central SOUTHCENTRALUTAHUS Southern Bell SOUTHWESTBELLUS Sprint PCS SPRINTUS Suncom SUNCOMUS RINA/Syringa Wireless SYRINGAUS Thumb Cellular THUMBUS T-Mobile USA TMOBILEUS Triton PCS TRITONPCSUS RINA/UBET UNITAHBASINUS United Wireless UNITEDWIRELESSUS US Cellular USCELLULARUS Verizon Wireless VERIZONUS Virgin USA VIRGINUS West Central Wireless WCENTRALUS Western Wireless WESTERNWUS
Comprehensive List of Canadian Providers
FIDOCA BELLCA TELUSCA SASKTELCA VIRGINCA MTSCA ROGERSCA
CUSTOMER LOGIN
LIVE SALES & SUPPORT
(Monday to Friday, 9am - 7pm EST)
Get Started With Our Text
Message Marketing Video
CLUB TEXTING CLIENTS
Read What Our Clients
Are Saying About Us!
CERTIFICATIONS
