Phone Number Validation API
Introduction
Similar to an email address, a phone number is an essential customer identifier. It is regularly used by businesses for sending important account updates, announcements, and security codes. Compared to email addresses, phone numbers provide a strong authentication method for account logins and other occasions making it an important data input that needs to be validated during various stages of the customer life-cycle.
One of the key challenges with phone numbers is getting them properly validated and formatted for storage on a database. People generally tend to format a phone number in a way that is popular within their region. As a result, there are a variety of ways in which businesses build their online form. This has resulted in non-standard practices and confusion between customers and businesses.
The Phone Number Validation API solves these specific problems related to phone number validation and formatting. Using this API, you can validate and convert phone numbers (any format) to the E164 standard format, international format or national format. In addition, the API also identifies the type of phone line, ie fixed-line, mobile, VoIP and so on.
You can learn more about how to store phone numbers in a database on our blog.
Get started
This API is part of the Phone number and Email verification package and is available in free and paid plans. Please visit the Phone number and Email verification package page for limits and pricing information.
Endpoints
IPv4 only API Endpoint
Use this endpoint to force API calls routed over the IPv4 network only
Dual-Stack API Endpoint
This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks
Request
Responses
Example query
https://api-bdc.net/data/phone-number-validate?number=201+867-5309&countryCode=us&localityLanguage=en&key=[YOUR API KEY]
Example response
Schema
Indicates whether the number is valid
The number formatted in E164 standard format
The number formatted in International dial format
The number formatted in local dial format
Estimated location localised to the language as defined by 'localityLanguage' request parameter
Line type detected. Possible values are: 'FIXED_LINE', 'MOBILE', 'FIXED_LINE_OR_MOBILE', 'TOLL_FREE', 'PREMIUM_RATE', 'SHARED_COST', 'VOIP', 'PERSONAL_NUMBER', 'PAGER', 'UAN', 'VOICEMAIL', 'UNKNOWN'
country object