/phone namespace · APlicious

Free Phone Validation API — built on libphonenumber, not a regex length check

The /phone namespace is built on libphonenumber-js — Google's numbering-plan library — distinguishing between a number that's merely the right length and one that matches a real, assigned pattern.

200+countries supported

Get free API key View docs

GET /api/v1/phone/validate

const res = await fetch(
  'https://aplicious.com/api/v1/phone/validate?number=%2B919876543210',
  { headers: { 'X-API-Key': 'lapi_live_••••' } }
);
const { data } = await res.json();
// { is_valid: true, is_possible: true, country_code: "IN", country: "India" }

No credit card · Free tier forever · X-API-Key header auth

What's included in /phone

Real numbering-plan validation

Checks against actual country-specific numbering plans, not a generic length or regex check.

Possible vs. valid

Distinguishes isPossiblePhoneNumber (right shape) from isValidPhoneNumber (matches a real assigned pattern) — a number can be possible without being valid.

Country detection

Returns the detected country code from the number itself, useful for routing or cost-estimation logic.

International format support

Handles E.164 and national formats across 200+ countries via the same library Android uses internally.

One key, every namespace

Pair with /email for full signup-form validation under one API key.

Start using the phone number validation API today

Free tier — 500 calls/month, no credit card. Upgrade when you need more.

Get free API key Explore /phone docs

Frequently asked questions

What library does this use?

libphonenumber-js, the JavaScript port of Google's libphonenumber — the same numbering-plan logic Android phones use internally.

Does it detect the country automatically?

Yes, from the number itself when in international (+) format.

Why isn't a 10-digit US-shaped number always valid?

Length alone doesn't guarantee the number matches an actually-assigned pattern for that country — that's exactly the gap libphonenumber closes.

Related API guides

One key unlocks all 34 namespaces — weather, finance, fitness, astrology, and more.

View all plans and pricing →