Invalid Number Response
Overview
If you send an API request for a number that we cannot check we will reject the request and populate your response with the following fields.
PARAMETER | WHAT TO EXPECT | FORMAT |
|---|---|---|
msisdn | The number used in the request | String |
error_code | 999 | Integer |
error_text | Number Not Supported | String |
status | Undelivered | String |
MCCMNC | null | Boolean |
is_ported | null | Boolean |
is_roaming | null | Boolean |
Note – We do not charge for a Number Not Supported response.
Reasons for a Number Not Supported Response
There’s a few possible reasons why your numbers are returned with Number Not Supported.
The number does not contain a valid country code
The number does not contain a valid number range
The number is to short or too long
The number is a landline number (exception for North America numbers)
We have no coverage for the owning network of the number
Example JSON Response
This is the JSON Response you will see
{
type: "",
msisdn: "441133910781",
error_code: 999,
error_text: "Number Not Supported",
status: "Undelivered",
mccmnc: "",
is_ported: null,
is_roaming: null
}