Whether the number is valid for its country, the country itself, the line type such as mobile, fixed line or VoIP, and the number rendered in E.164, international and national formats.

Do I have to send the country code?

No. Send an international number as is, or a national number together with a default country, and the API parses it either way.

Which countries are supported?

Every country and territory with a numbering plan, using the metadata of the libphonenumber project that powers phone handling in Android and many carriers.

Does it confirm the number is in service?

No. Validity means the number matches its country's numbering plan. Whether it is active or who owns it would need a carrier lookup, which this API does not perform.

What does a call cost?

1 token. The free plan covers 500 validations a month.

ToolsMAINTAINED1 token / call

Phone Number Validation API

Validate, type and format phone numbers for every country in E.164, international and national forms

Validate and parse phone numbers for every country: validity, country, line type (mobile, fixed line, VoIP), and E.164, international, and national formats. Accepts international input or national format plus a default country.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "input": "+14155552671",
  "valid": true,
  "country": "US",
  "country_calling_code": "+1",
  "type": "FIXED_LINE_OR_MOBILE",
  "e164": "+14155552671",
  "international": "+1 415 555 2671",
  "national": "(415) 555-2671"
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Phone Number Validation API

Normalise numbers to E.164 at signup so SMS verification and CRM deduplication work across countries.
Reject landlines or VoIP numbers where a mobile is required for two-factor authentication or delivery alerts.
Format numbers for display in the user's national style on invoices, profiles and contact cards.
Detect the country of a number to route calls, pick a language or apply regional pricing.

Phone Number Validation API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETValidate Phone

GETValidate Phone

https://api-phone-validation.dataandapis.com/v1/phone

Query parameters

Parameter	Example
country	US	Optional
number	+14155552671	Required

Example request

curl "https://api-phone-validation.dataandapis.com/v1/phone?country=US&number=%2B14155552671" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "input": "+14155552671",
  "valid": true,
  "possible": true,
  "country": "US",
  "country_calling_code": "+1",
  "type": "FIXED_LINE_OR_MOBILE",
  "e164": "+14155552671",
  "international": "+1 415 555 2671",
  "national": "(415) 555-2671",
  "uri": "tel:+14155552671"
}

Where the data comes from

Source: libphonenumber metadata (MIT licence), the same numbering-plan data used by Android and major telecom systems. Pure computation, no external call.
Freshness: Computed on every call. Numbering-plan metadata is updated with each release.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

1endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-phone-validation.dataandapis.com/v1/phone',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Phone Number Validation API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Query Parameters

country(Optional)

number(Required)

Target:

Client:

import axios from 'axios';

const url = 'https://api-phone-validation.dataandapis.com/v1/phone';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});