Phone Number Lookup
Free tierValidate, format, and enrich phone numbers in 232 countries.
About this API
Parse any phone number into E.164, national, and international formats, then enrich it with carrier, line type, portability status, and active-line signals drawn from live HLR lookups.
Common use cases
Quickstart
Every Zephiel API uses the same base URL, the same key header, and the same error envelope.
curl -X GET "https://zephiel.com/api/v1/phone-lookup/validate" \
-H "X-Zephiel-Key: $ZEPHIEL_API_KEY" \
-H "Accept: application/json"Example response
{
"number": "+2348031234567",
"valid": true,
"country_code": "NG",
"line_type": "mobile",
"carrier": "MTN Nigeria",
"ported": false
}/v1/phone-lookup/validateValidate and format a number/v1/phone-lookup/carrierCarrier and line-type lookup/v1/phone-lookup/batchValidate up to 500 numbers at onceAll endpoints return JSON and accept the X-Zephiel-Key header. Rate limits are enforced per plan and reported in X-RateLimit-Remaining.
Plans can be changed or cancelled at any time. Overage is charged per 1,000 requests rather than hard-blocking your traffic.
Free
100 requests/mo
5 req/min
Free
- JSON output format — included
- HTTPS encryption — included
- API key authentication — included
- Standard endpoints — included
- Community support — included
- CSV output format — not included
- Email support — not included
- Usage analytics and alerts — not included
- 99.9% uptime SLA — not included
- Webhooks — not included
- Priority support — not included
- Custom rate limits — not included
- 99.99% uptime SLA — not included
- Dedicated success manager — not included
- SSO / SAML — not included
- Custom SLA, DPA, and BAA — not included
- Private deployment option — not included
- Volume pricing — not included
Starter
10,000 requests/mo
60 req/min
$14/month
- JSON output format — included
- HTTPS encryption — included
- API key authentication — included
- Standard endpoints — included
- Community support — included
- CSV output format — included
- Email support — included
- Usage analytics and alerts — included
- 99.9% uptime SLA — included
- Webhooks — not included
- Priority support — not included
- Custom rate limits — not included
- 99.99% uptime SLA — not included
- Dedicated success manager — not included
- SSO / SAML — not included
- Custom SLA, DPA, and BAA — not included
- Private deployment option — not included
- Volume pricing — not included
Most popular
Pro
250,000 requests/mo
600 req/min
$56/month
- JSON output format — included
- HTTPS encryption — included
- API key authentication — included
- Standard endpoints — included
- Community support — included
- CSV output format — included
- Email support — included
- Usage analytics and alerts — included
- 99.9% uptime SLA — included
- Webhooks — included
- Priority support — included
- Custom rate limits — included
- 99.99% uptime SLA — included
- Dedicated success manager — not included
- SSO / SAML — not included
- Custom SLA, DPA, and BAA — not included
- Private deployment option — not included
- Volume pricing — not included
Enterprise
Unlimited requests
Custom
$196/month
- JSON output format — included
- HTTPS encryption — included
- API key authentication — included
- Standard endpoints — included
- Community support — included
- CSV output format — included
- Email support — included
- Usage analytics and alerts — included
- 99.9% uptime SLA — included
- Webhooks — included
- Priority support — included
- Custom rate limits — included
- 99.99% uptime SLA — included
- Dedicated success manager — included
- SSO / SAML — included
- Custom SLA, DPA, and BAA — included
- Private deployment option — included
- Volume pricing — included
4.6
12 reviews
Mei Chen
Integration Engineer
Solved SMS deliverability for us
We brought Phone Number Lookup in for SMS deliverability and it has not needed revisiting since. The response shape matched the documentation on the first call, which is rarer than it should be.
Peter Osei
DevOps Lead
Fast enough to sit in the request path
210ms median is quick enough that we call Phone Number Lookup synchronously rather than queueing it. That removed a whole background worker from our architecture.
Rachel Kimani
Head of Integrations
Free tier covered the whole prototype
I built the entire crm enrichment flow against Phone Number Lookup before anyone had to approve a purchase order. By the time we paid, we already knew it worked.
Chidi Nwosu
Head of Engineering
Replaced a fragile in-house validation job
We had a script doing fraud prevention that broke every few months and only one person understood. Phone Number Lookup replaced it in an afternoon and nobody maintains it now.
James O'Connor
Technical Director
Errors are actually readable
When something goes wrong Phone Number Lookup says what and why, with a code I can branch on. I have integrated hlr services that return 200 with an error buried in the body, so this is a relief.
Aisha Suleiman
Digital Lead
Held up under real load
We push Phone Number Lookup hard during peak and latency has stayed flat. No throttling surprises, no silent degradation — the numbers on the listing matched what we measured.
Anna Kowalski
Senior Developer
Good coverage for carrier
We checked Phone Number Lookup against our own carrier reference data before committing. Coverage was better than the incumbent we were paying four times as much for.
Yusuf Abdullahi
Head of Engineering
Documentation matched reality
Every sample in the Phone Number Lookup docs ran unmodified. That sounds like a low bar until you have integrated something where it is not.
Related APIs in Communication
Email Verification
Free tierZephiel Labs
Validate deliverability before you ever hit send.
SMS Gateway
Northwind Data
Reach 200+ countries with direct carrier routes.
Push Notifications
Free tierNorthwind Data
One call to reach iOS, Android, and the web.