/check API Response

An example of the response you'll receive and a breakdown of the paramaters

{
    "status": "OK",
    "data": {
        "447540822872": {
            "msisdn": "447540822872",
            "status": "Delivered",
            "error_code": 0,
            "error_text": "Live",
            "original_network_name": "O2 (Telefonica) UK Limited",
            "ported_network_name": "T-Mobile (Everything Everywhere) Limited",
            "mccmnc": "23430",
            "original_country_name": "United Kingdom",
            "original_country_prefix": 44,
            "ported_country_name": "United Kingdom",
            "ported_country_prefix": 44,
            "is_roaming": false,
            "roaming_network_name": "",
            "roaming_country_prefix": "",
            "roaming_network_prefix": "",
            "is_mobile": "Mobile"
        }
    },
    "err": []
}

Breakdown of responses

Parameter

Result

msisdn

The number used for the lookup.

status

Expect: Delivered, Undelivered or Rejected.

error_code

Expect one of the following. Each error code directly relates to an error_text result listed below:
0,1,5,7,11,27,999

error_text

Expect one of the following:
• Live (0)
• Dead (1)
• Inconclusive (5)
• Insufficient Credit (7)
• No Teleservice Provisioned (11)
• Absent Subscriber (27)
• Number Not Supported (999)

A more detailed description can be found on the Error Text Descriptions error text description page.

original_network_name

The name of the originating network.

ported_network_name

The name of the current network.

Only supplied on Live numbers.

mccmnc

The MCC and MNC identify the Mobile Country Code and Mobile
Network Code and relates to the Current Network of the number.

For Live numbers the current MCCMNC will be given.
For Absent Subscribers / Dead / No Teleservice Provisioned and Inconclusive results the MCCMNC of the Original network will be given.

original_country_name

Country of the Original Network for this number.

original_country_prefix

The Country Code of the location of the Original Network.

You can get details of Country Codes by using our Coverage Checker page.

ported_country_name

Home country of the Current Network for this number.

Only supplied on Live numbers.

ported_country_prefix

The country code of the location of the Current Network.

Only supplied on Live numbers.

is_roaming

Expect TRUE or FALSE. Indicates if the number is currently roaming outside of its home location.

Not available for every country or network.

roaming_network_name

The network name that the number is currently roaming on.

Only supplied if number is Live and Roaming.

roaming_country_prefix

The country code of the location of the roaming network.

Only supplied if number is Live and Roaming.

roaming_network_prefix

The prefix of the network the number is roaming on.

Only supplied if number is Live and Roaming.

is_mobile

For numbers prefixed with "1"
Expect:
• Landline / Mobile / Pager/ VoIP or Unknown
All other country codes expect:
• Mobile