P

Phone Number Validation API

Freemium

Validate and format phone numbers for 240+ countries: valid or not, mobile or landline, carrier, region, and E.164 format.

No reviews yet
1.6Popularity100%Service Level517msLatency
SMSphone verificationcarrier lookupe164 formatmobile number check

Documentation

Validate and format phone numbers for 240+ countries: valid or not, mobile or landline, carrier, region, and E.164 format.

What you get

  • Validation for 240+ countries and territories
  • Line type — mobile, fixed line, toll-free, VoIP…
  • Carrier and region where available
  • Formatting — E.164, international, national, and how to dial from another country
  • Batch up to 100 numbers

Great for sign-up and OTP flows, SMS campaigns, CRM clean-up and checkout forms.

Quick start

Subscribe to a plan (the Basic plan is free), then call the API at https://phone-number-validator.p.apihiver.com with your key in the X-API-Key header:

curl "https://phone-number-validator.p.apihiver.com/v1/validate?number=+919876543210" \
  -H "X-API-Key: YOUR_API_KEY"

Endpoints

MethodPathWhat it does
GET/v1/validateValidate and format a phone number
POST/v1/validate/batchValidate up to 100 phone numbers
GET/v1/exampleAn example number for a country and type
GET/v1/formatFormat a number for display (E.164, international, national, or as dialled from another country)
GET/v1/countriesCalling codes for every country

Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.

Errors

Every error is JSON with the same shape:

{"error": {"code": "INVALID_INPUT", "message": "number: Field required"}}
HTTPCodeMeaning
400INVALID_INPUTA parameter is missing or has the wrong format — the message says which
401UNAUTHORIZEDMissing or invalid X-API-Key
429—Plan quota or rate limit reached (see the X-RateLimit-* headers)
502 / 503 / 504—A data source or the API server is temporarily unavailable — retry after a few seconds

Data & privacy

Data comes from Google's libphonenumber, running on our servers. No call or SMS is ever made.

Phone Number Validation API FAQ

Is the Phone Number Validation API free?
Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.
How much does the Phone Number Validation API cost?
Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.
How do I use the Phone Number Validation API?
Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://phone-number-validator.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
What endpoints does the Phone Number Validation API have?
It has 5 endpoints: Validate and format a phone number (GET /v1/validate); Validate up to 100 phone numbers (POST /v1/validate/batch); An example number for a country and type (GET /v1/example); Format a number for display (E.164, international, national, or as dialled from another country) (GET /v1/format); Calling codes for every country (GET /v1/countries).
What are the Phone Number Validation API rate limits?
Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
Can I use one API key for the Phone Number Validation API and other APIs?
Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.

Reviews

Loading reviews…

Log in to write a review.