On this page

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.

Endpoint

GET
https://api.bigdatacloud.net/data/phone-number-validate

Request

Parameter
Type
Required
Description
Parameter
number
Type
string
Required
Yes
Description
Phone number to validate
Parameter
countryCode
Type
string
Required
Yes
Description
Country code, acceptable in ISO 3166-1 Alpha-2, Alpha-3 or Numeric code formats
Parameter
localityLanguage
Type
string
Required
Optional, default value: en
Description
Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is not available for a requested location, it will default to English. If no English variant is known, will provide the native, local names
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

Example query

https://api.bigdatacloud.net/data/phone-number-validate?number=201+867-5309&countryCode=us&localityLanguage=en&key=[YOUR API KEY]
  

Example response

Schema

application/json