Loading
Loading
Verify phone numbers and retrieve detailed metadata including carrier name, line type, geographic location, time zones, and standardized formats.
Send the phone number in the request body. The response includes validation status, carrier information, line type detection, location data, and four standardized formats (E.164, International, National, RFC3966).
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
formatoptionalStringdefault: jsonResponse format: 'json'.
The request body must be in JSON format and include the number field to validate:
{
"number": "+14155552671"
}numberrequiredStringThe phone number to validate. Can include international prefix (+), local format, or IDD exit code format.
regionoptionalStringISO-2 country code (e.g., US, GB) for unambiguous parsing. Required when number is provided in local format without a country code prefix.
dialer_regionoptionalStringISO-2 country code of the dialing origin (e.g., AU, US). Used for IDD exit code processing.
A successful request returns a 200 OK response with a JSON object containing validation status and metadata for the queried phone number.
possibleWhether the number is possible (length and format checks only). A number can be possible but not valid.
validWhether the number is valid according to the numbering plan.
country_prefixThe international dialing prefix for the number's country (e.g., 1 for US/Canada, 44 for United Kingdom).
national_numberThe national significant number (the phone number without the country code).
country_codeISO-2 country code inferred from the number (e.g., US, GB).
carrierCarrier name associated with the number (if available). May not reflect ported carriers.
locationGeographic description (city/region) for the number (if applicable).
time_zonesArray of possible time zones associated with the number.
line_typeClassification of the phone line (MOBILE, FIXED_LINE, VOIP, etc.).
area_code_lengthLength of the geographic area code. Only applies to geographically-assigned numbers.
ndc_lengthLength of the National Destination Code (NDC), the routing prefix within a country.
can_be_internationally_dialledWhether the number can be dialled internationally. false for short codes, emergency numbers, and domestic-only services.
number (String), region (String), dialer_region (String)
E164 (String), International (String), National (String), RFC3966 (String)
All possible values for the line_type field:
MOBILEMobile or cellular number.
FIXED_LINEWired landline number.
FIXED_LINE_OR_MOBILECould be either. Some countries don't distinguish between the two.
VOIPVoice over IP number (e.g., Google Voice, Skype).
TOLL_FREEFree for the caller. Receiver pays (e.g., 1-800 numbers).
PREMIUM_RATECaller is charged above the normal rate.
SHARED_COSTCost is split between caller and receiver.
PERSONAL_NUMBERAssigned to a person, not a device. Can forward to any phone.
PAGERPaging device number.
UANUniversal Access Number. Routes to different destinations based on caller location.
VOICEMAILDedicated voicemail service number.
UNKNOWNType could not be determined.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
The 'number' is required in Post Body and cannot be empty.
Provide the region explicitly (e.g. 'US') or include a '+' with the country code.
Provide only one region code, either 'region' or 'dialer_region', not both.
Region code must be a 2-letter ISO country code (e.g., 'US', 'GB').
The input does not match the expected structure of a phone number.
The number is too short after removing the international dialing prefix.
The national number part is shorter than allowed for valid phone numbers.
The phone number has more digits than any valid phone number can have.
Wrong HTTP method was used on the endpoint.
Timed out while connecting to the remote URL.