100 free requests / month · no credit card

The Phone Validation API
built for clean phone verification

Format, country, region, carrier, line type, disposable detection — in a single REST call. No SMS sent. No fake accuracy claims. Transparent diagnostics on every number.

Get started free Try it live
100 free requests / month · Cancel anytime · No SMS, no probing

Try our phone verification API live

Type any phone number and see the real response from our API.

3 free demo validations per IP. Sign up for a real API key with 100 free requests every month.

How our phone validation API works

Three steps, one REST call.

1

Get your API key

Sign up for free — 100 requests per month are unlocked instantly. Your API key is ready immediately — no approval, no credit card.

2

Make a POST request

Send any phone number to /api/v1/validate with your Bearer token. Works from any language: PHP, Python, Node.js, Ruby, Go.

3

Use the response

Structured JSON with valid, confidence, line_type, carrier, and per-check diagnostics.

Drop-in integration

Copy, paste, validate. No SDK required — any HTTP client works.

Full documentation → 
# Bash / curl
curl https://phonevalidationapi.com/api/v1/validate \
  -H "Authorization: Bearer pvs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"phone":"+33612345678"}'
{
  "valid": true,
  "confidence": "verified",
  "score": 0.95,
  "reason": "valid",
  "formatted": {
    "e164": "+33612345678",
    "national": "06 12 34 56 78",
    "international": "+33 6 12 34 56 78"
  },
  "country": { "iso2": "FR", "code": 33 },
  "line_type": "mobile",
  "carrier": "SFR",
  "is_disposable": false,
  "credits_remaining": 24
}

Why developers choose our phone verification API

Country & carrier detection

Automatic country resolution from E.164, line type classification (mobile/landline/VoIP/toll-free) and carrier name where available.

Disposable detection

Catches Google Voice, TextNow, Hushed, Burner, Pinger, Bandwidth and other VoIP carriers commonly used for fraud and throw-away accounts.

Honest confidence levels

Per-number confidence: verified, likely, uncertain, low. We tell you when we're sure and when we're not — no inflated accuracy.

Fast response

5–30ms typical, no external network calls. Bulk async endpoint for processing thousands of numbers at once.

Privacy-friendly

No SMS sent, no PSTN dial, no charge to number owners. Numbers are SHA-256 hashed — never stored in clear in our logs.

No surprise bills

Generous Free plan (100/month). Paid plans hard-cap at your quota — no surprise overage bills. Cancel or change plans anytime.

Our promise to developers

No fake "99% accuracy" claims.

Format and metadata validation has real limits — some countries have ambiguous line types, some carriers issue both mobile and VoIP numbers under the same brand. We tell you exactly what we know, and what we don't.

FAQ

A phone validation API is a REST service that verifies whether a phone number is correctly formatted, identifies its country and carrier, and detects line type (mobile, landline, VoIP, toll-free). It helps you clean signup forms and contact databases without sending an SMS.

We parse the number with Google's libphonenumber to extract format (E.164), country, region, line type, and carrier. We then cross-check the carrier against our profile database of known VoIP and disposable carriers (Google Voice, TextNow, Hushed, Pinger, Bandwidth, Twilio, …) and return a confidence label: verified, likely, uncertain, or low.

No. We do format and metadata validation only — no SMS sent, no PSTN ringing, no charge to the number owner. This is a privacy-friendly check that catches most invalid or risky numbers without invasive probing. (Live HLR lookups will be available as a paid tier later.)

It depends on the country. Mobile numbers in well-regulated markets (FR, US, UK, DE, JP) are reliably classified with carrier and line type. Some countries have looser numbering plans where libphonenumber returns 'fixed_line_or_mobile' — we mark these as 'likely' rather than pretending to know. We're transparent about uncertainty rather than inflating accuracy claims.

Yes. We maintain a curated database of carriers known to issue disposable / VoIP grand-public numbers (TextNow, Hushed, Burner, Pinger, Google Voice, …) plus a list of known VoIP prefixes. When detected, the API returns confidence=low and reason=disposable_voip.

Two formats are supported: (1) E.164 with leading "+" (e.g. +33612345678) — country auto-detected. (2) National format (e.g. 0612345678) — requires a `country` parameter (ISO-3166 alpha-2: FR, US, GB, …).

Each plan includes a monthly quota of API requests. Your quota resets at the start of each billing cycle. The Free plan gives you 100 requests per month — no credit card required. If you hit your quota mid-cycle, you can upgrade your plan instantly or wait for the next cycle.

Format-only validation typically returns in 5–30ms, since it runs entirely in-memory without external network calls. Async batch endpoint available for processing thousands of numbers at once.

Start validating phone numbers in 30 seconds.

100 free requests every month, no credit card. Upgrade anytime from $14.99/mo.

Get started free