Dexatel API Documentation

Advanced Does Not Mean Complicated

Valid Mobile Number Response

Listed below are the fields you will see in an API response for any valid mobile number.

Your JSON response is broken down into four objects, the current status of the mobile number you have checked will dictate the JSON objects we will display within your result.


– issueing_info:

Displayed for all valid mobile numbers

Field What to expect Format
verified True - this indicates that this is a valid mobile number Boolean
timezone The timezone of the country where the original network is located String
location The country of the original network for the entered number String
network_name The name of the originating network String
country_code The country code of the location of the orginal network Integer
area The country of the the original network for the number entered String
region String
– home_info:

Displayed for all numbers reported as LIVE

Field What to expect Format
verified True - Indicates that this is a valid mobile number Boolean
timezone The timezone of the country where the original network is located String
location The home country of the current network for the entered number String
network_name The name of the current network of the entered number String
country_code The country code of the location of the current network Integer
area The country of the the current network for the number entered String
region String
– roaming_info:

Displayed when a VALID and LIVE mobile number is identified as roaming away from it’s Home Country

Field What to expect Format
verified True - Indicates that this is a valid mobile number Boolean
timezone The timezone of the country where the original network is located String
location The home country of the current network for the entered number String
network_name The name of the current network of the entered number String
country_code The country code of the location of the current network Integer
area The country of the the current network for the number entered String

If the results for a mobile number believed to be roaming away from it’s Home location do not show the number as Roaming then it is most likely Home Routing has been implemented by the Network Operator.

This means that the network will always report their numbers as being located in their Home location regardless of where they are in the world.

Status Information

These response fields indicate the current status of the number you have entered. You should use this part of the API response to determine if your numbers are Live or Dead etc.

Field What to expect Format
type Mobile String
msisdn The number used for the HLR Lookup String
error_code Check the table below for more details Integer
error_text Check the table below for more details String
status Delivered, Undelivered or Rejected String
mccmnc The MCC and MNC identify the Mobile Country Code and Mobile Network Code String
is_ported Will indicate if the number has been ported from it's Original Network to a different Current Network Boolean
is_roaming Will indicate if the number is currently roaming outside of it's home location Boolean
Error codes & texts

For every valid number processed through the API we’ll return information regarding the current status of that number.

It is this information you can use to determine if your numbers are currently live and contactable.

There are 3 specific fields returned in the Status Information section of your API result that that tell you the current Status.

error_code, error_text and Status are all linked and you can use any of these fields.

For example, anything marked as Live will always be Error Code 1 and Status Delivered

All other Error Texts and Error Codes do not reflect a Live a number and are therefore marked in the Status column as Undelivered

Error code Error text Status Description
0 Live Delivered Active mobile number
1 Dead Undelivered Number decommissioned by the owning network
5 Inconclusive Undelivered We are unable to retrieve a response from the network for this number
11 No Teleservice Provisioned Undelivered This number is not able to receive calls or SMS messages. This is usually a number relating to a data SIM
27 Absent Subscriber Undelivered There are a number of ways a number can be returned as Absent Subscriber Please see our Absent Subscriber information page for further details.
99 Number Not Supported Undelivered There are a number of reasons a number can be returned as "Number Not Supported" please see our Invalid number page for further details

Have more questions?


Dexatel aims to build a better future where technology creates good connections and communication for everyone and everywhere.