CTRL+K

Bulk Phone Number Validation

POST

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

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
-	Array	Mandatory	Returns an array of phone validation objects. To see the complete response structure for each phone number, refer to the API Response Fields section below .

Each item in the response array corresponds to a phone number validation result with the following fields:

Field	Type	Requirement	Description
raw_input	Map	Mandatory	The original request data provided by the client. Contains number, region, and dialer_region.
raw_input.number	String	Mandatory	The phone number as entered by the user. Can include international prefix (+), local format, or IDD exit code format.
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. Present when provided in the request.
possible	Boolean	Mandatory	Whether the number is possible (length and format checks only). A number can be possible but not valid.
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 (e.g., 1 for US/Canada, 44 for United Kingdom).
national_number	Integer	Optional	The national significant number (the phone number without the country code).
country_code	String	Optional	ISO-2 country code inferred from the number (e.g., US, GB).
carrier	String	Optional	Carrier name associated with the number (if available). May not reflect ported carriers.
location	String	Optional	Geographic description (city/region) for the number (if applicable).
time_zones	Array<String>	Optional	Array of possible time zones associated with the number.
line_type	String	Optional	Classification of the phone line (see Line Types Reference below).
formats	Map	Optional	The number represented in four standardized formats. Only returned for valid numbers.
formats.E164	String	Optional	Number in E.164 format, the standard machine-readable format used for storage and APIs. No spaces or punctuation. Example: +14155552671.
formats.International	String	Optional	Human-readable international format with country code, spaces, and punctuation. Example: +1 415-555-2671.
formats.National	String	Optional	Local format as dialed within the country, without the country code. Example: (415) 555-2671.
formats.RFC3966	String	Optional	URI format following RFC 3966, used for tel: links in HTML and SIP/VoIP applications. Example: tel:+1-415-555-2671.
area_code_length	Integer	Optional	Length of the geographic area code. Only applies to geographically-assigned numbers (typically landlines). Field is not returned for mobile and non-geographic numbers.
ndc_length	Integer	Optional	Length of the National Destination Code (NDC), the routing prefix within a country. Unlike area_code_length, this covers both geographic area codes and mobile operator prefixes.
can_be_internationally_dialled	Boolean	Optional	Whether the number can be dialled internationally. false for short codes, emergency numbers, and domestic-only services.

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.