Phone Number Validation API
FreemiumValidate and format phone numbers for 240+ countries: valid or not, mobile or landline, carrier, region, and E.164 format.
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
| Method | Path | What it does |
|---|---|---|
GET | /v1/validate | Validate and format a phone number |
POST | /v1/validate/batch | Validate up to 100 phone numbers |
GET | /v1/example | An example number for a country and type |
GET | /v1/format | Format a number for display (E.164, international, national, or as dialled from another country) |
GET | /v1/countries | Calling 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"}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing 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.
Related APIs
Search universities in 200+ countries, look up a university by web domain, and verify student email addresses.
Create QR codes for links, text, UPI payments, Wi-Fi logins and contact cards (PNG/SVG, custom colours) and read QR codes from images.
Public holidays for 150+ countries — including Indian states — plus 'is it a holiday?', upcoming holidays and working-day counts.
Password strength scoring, private breach checks against known leaked passwords, secure password generation, hashing and bcrypt checks.
Extract text from images and scans in English, Hindi and Marathi, and pull out emails, phone numbers, URLs, PAN and GSTIN.
Detect throwaway and temporary email addresses (Mailinator, 10MinuteMail and 8,900+ more domains) at sign-up — single, batch or classify.
Endpoints
5 endpoints — full list is in the sidebar on larger screens.