API output elements

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.

Metadata fields

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