The response from this API will contain a section (represented as a JSON object) for each type of data returned. Response elements that may be included in this section:
Body fields
| Field |
Description |
| number |
The phone number that you are submitting for validation, either in the format local to your country or with phone country code. |
| validated_phone_number |
The validated phone number. Also includes the international country calling code. Note that this field is returned even if the phone number has a confidence status of "Unverified" |
| country_iso |
A 3 letter country ISO code if the number is a format that's local to your country. |
| formatted_phone_number |
The phone number in the format you specified in "output_format". |
| phone_type |
The type of phone number (see "Phone type" section for detailed description) |
| confidence |
The outcome of the validation (see Confidence level section for detailed description) |
| ported_date |
The date that the phone number was last ported if the number has been ported to a different network other than the originally assigned network. This value would be returned if the get_ported_date boolean is set to true. |
| disposable_number |
This field will return a Yes if the number is known to be from a disposable network, or has been found on a website advertising disposable numbers, otherwise it will return an Unknown. |
| Field |
Description |
| original_operator_name |
The name of the MSISDN operator where the phone number was originally registered. |
| original_network_status |
The status of the network where the phone number was originally registered. |
| original_home_network_identity |
The Mobile Country Code (MCC) and Mobile Network Code (MNC) where the phone number was originally registered. |
| original_country_prefix |
The international calling code of the country where the phone number was originally registered. |
| original_country_name |
The name of the country where the phone number was originally registered. |
| original_country_iso |
The 3-letter ISO code of the country where the phone number was originally registered. |
| operator_name |
The name of the MSISDN operator where the phone number is currently registered. |
| network_status |
The status of the network where the phone number is currently registered. |
| home_network_identity |
The Mobile Country Code (MCC) and Mobile Network Code (MNC) where the phone number is currently registered. |
| country_prefix |
The international calling code of the country where the phone number is currently registered. |
| country_name |
The name of the country where the phone number is currently registered. |
| country_iso |
The 3-letter ISO code of the country where the phone number is currently registered. |
| is_ported |
Indicates whether the phone number is ported or not. |
| cache_value_days |
The requested number of days to look back in the cache for this phone number. |
| date_cached |
The last date this phone number was checked. |
| (Optional) email_to_sms_address* |
Email address which can be used to send SMS messages to this phone number. |
| (Optional) email_to_mms_address* |
Email address which can be used to send MMS messages to this phone number. |
* Only supported in some countries
Supported Countries
| Country |
Network |
| Argentina |
Claro |
|
Movistar |
|
Nextel |
|
Alertas Personal |
| Aruba |
Setar |
| Australia |
Optus Mobile |
| Brazi |
Claro |
|
Vivo |
| Bulgaria |
Mobitel |
| Canada |
Aliant Mobility |
|
Bell |
|
Fido |
|
Telus Mobility |
|
Lynx Mobility |
|
MTAS Mobility |
|
Rogers Wireless |
|
Sasktel |
|
Virgin Mobile Canada |
| China |
China mobile |
| Colombia |
Claro (formerly Comcel) |
|
Movistar |
| Dominica |
Digicel |
| Egypt |
Vodafone |
| France |
SFR (** limited coverage) |
|
Bouygues Telecom (** limited coverage) |
| Guyana |
Cellink |
| Hong Kong |
CSL Hong Kong |
| Iceland |
Vodafone |
|
Siminn |
| India |
Aircel |
|
Airtel elap |
|
Airtel Chennai |
|
Airtel Karnataka |
|
Airtel Kerala |
|
Airtel Kolkata |
|
Airtel Tamil Nadu |
|
Idea Cellular |
|
Loop Mobile |
| Ireland |
Meteor |
|
Vodafone |
| Japan |
KDDI |
|
NTT Doomo |
|
Softbank |
|
Y Mobile |
| Mauritius |
Emtel |
| Nepal |
NCell (Axiata) |
| New Zealand |
Telecom New Zealand |
|
Vodafone |
| Panama |
Cable Wireless |
| Poland |
Orange |
|
Plus |
| Puerto Rico |
Claro |
| Russia |
Beeline |
| Singapore |
M1 |
| Spain |
Movistar |
|
Vodafone |
| South Africa |
MTN |
|
Vodacom |
| Sri Lanka |
Mobitel |
| Sweden |
Tele2 |
| Switzerland |
Sunrise |
| Korea |
SK Telecom |
| Ukraine |
Beeline |
| USA |
Alltel |
|
Alaska Communications |
|
AT&T |
|
Boost Mobile |
|
Bluegrass Cellular |
|
Carolina West Wireless |
|
Cellcom new cell Inc |
|
Cellcom Nsighttel Wireless |
|
Cellcom NSight Spectrum |
|
C Spire Wireless |
|
Chariton Valley Communications |
|
Cincinnati Bell |
|
Chat Mobility |
|
DTC Wireless |
|
GCI Wireless |
|
IOWA Wireless Services |
|
Metro PCS |
|
Nextel |
|
Pioneer Cellular |
|
Sprint |
|
Southern Communications |
|
Syringa Wireless |
|
T Mobile |
|
US Cellular |
|
Verizon |
|
Viaero |
|
Virgin Mobile |
|
West Central |
| Uruguay |
Movistar |
