/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 |
Updated about 7 years ago