CTRL+K

Phone Number Validation

POST

https://api.apifreaks.com/v1.0/phone/validation

Sample Responses

400

500

LANGUAGE

Python

PHP

Java

Node

Ruby


$ pip install requests

RESPONSE

Click Test it to start the request and see the response here!

API Response

Field	Type	Requirement	Description
raw_input	Map	Mandatory	The original request data provided by the client.
raw_input.number	String	Mandatory	The phone number as entered by the user.
raw_input.region	String	Optional	ISO-2 country code (e.g., US, GB). Present when provided in the request.
raw_input.dialer_region	String	Optional	ISO-2 country code of the dialing origin (e.g., AU, US). Present when provided in the request.
possible	Boolean	Mandatory	Whether the number is possible (length and format checks only).
valid	Boolean	Mandatory	Whether the number is valid according to the numbering plan.
country_prefix	Integer	Optional	The international dialing prefix for the number's country.
national_number	Integer	Optional	The national significant number without the country code.
country_code	String	Optional	ISO-2 country code inferred from the number.
carrier	String	Optional	Carrier name associated with the number.
location	String	Optional	Geographic description (city/region) for the number.
time_zones	Array<String>	Optional	Array of possible time zones associated with the number.
line_type	String	Optional	Classification of the phone line (MOBILE, FIXED_LINE, VOIP, etc.).
formats	Map	Optional	The number represented in four standardized formats.
formats.E164	String	Optional	Number in E.164 format, the standard machine-readable format.
formats.International	String	Optional	Human-readable international format with country code and spaces.
formats.National	String	Optional	Local format as dialed within the country.
formats.RFC3966	String	Optional	URI format following RFC 3966, used for tel: links.
area_code_length	Integer	Optional	Length of the geographic area code.
ndc_length	Integer	Optional	Length of the National Destination Code (NDC).
can_be_internationally_dialled	Boolean	Optional	Whether the number can be dialled internationally.

Line Types Reference

All possible values for the line_type field:

Value	Description
MOBILE	Mobile or cellular number.
FIXED_LINE	Wired landline number.
FIXED_LINE_OR_MOBILE	Could be either. Some countries don't distinguish between the two.
VOIP	Voice over IP number (e.g., Google Voice, Skype).
TOLL_FREE	Free for the caller. Receiver pays (e.g., 1-800 numbers).
PREMIUM_RATE	Caller is charged above the normal rate.
SHARED_COST	Cost is split between caller and receiver.
PERSONAL_NUMBER	Assigned to a person, not a device. Can forward to any phone.
PAGER	Paging device number.
UAN	Universal Access Number. Routes to different destinations based on caller location.
VOICEMAIL	Dedicated voicemail service number.
UNKNOWN	Type could not be determined.