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; 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 out of their own networks.

We offer both HTTP and REST Carrier Lookup APIs. Please make sure that you are reading the correct documentation for the API that you are using to connect to Club Texting's Carrier Lookup Service. Both APIs return carrier codes from the table at the bottom of this page (View List).

REST Carrier Lookup API

Our REST Carrier Lookup API can return both JSON and XML results. You may specify the format you prefer in your request. Looking for Code Samples? Choose your language from the navigation bar to the left.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Status>Failure</Status>
    <Code>401</Code>
    <Errors>
        <Error>Authorization Required</Error>
    </Errors>
</Response>

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Status>Failure</Status>
    <Code>403</Code>
    <Errors>
        <Error>PhoneNumbers: '(123)45-67' contains characters which are not digits</Error>
    </Errors>
</Response>

curl "https://app.clubtexting.com/sending/phone-numbers/2345678910?User=winnie&Password=the-pooh&format=xml"

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Status>Success</Status>
    <Code>200</Code>
    <Entry>
        <PhoneNumber>2345678910</PhoneNumber>
        <CarrierName>ATTUS</CarrierName>
    </Entry>
</Response>

curl "https://app.clubtexting.com/sending/phone-numbers/2345678910?User=winnie&Password=the-pooh&format=json"

{
    "Response":{
        "Status":"Success",
        "Code":200,
        "Entry":{
            "PhoneNumber":"2345678910",
            "CarrierName":"ATTUS" 
        }
    }
}

HTTP Carrier Lookup API

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 API In Other Languages

• C#
• Java
• Perl
• PHP
• Python
• Ruby

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:

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=2345678901

Parsing simple text response (default response)

The meaning of the response received is:

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