Phone Number API

Validate and format a number. 245 countries and regions.

Check a phone number before you store it. Pass +14155552671 and get back phone, valid, country, plus national and international when it checks out.

A North American local number like (415) 555-2671 is detected from the area code. Other national formats take ?country=. Junk answers valid: false as a 200, never a 404. Everything here is computed locally and draws pooled requests only.

type is what the numbering plan says, so it never says voip — the network knows that. Same number, sibling endpoints: /carrier for who serves it, /caller for the name, /hlr for live status.

Validate

GET

api.parseapi.com/phone/{number}

Validate and format. Optional ?country= (ISO2) for national numbers

curl "https://api.parseapi.com/phone/+14155552671" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "phone": "+14155552671",
  "valid": true,
  "country": "US",
  "type": "landline",
  "state": "CA",
  "state_name": "California",
  "national": "(415) 555-2671",
  "international": "+1 415-555-2671"
}

curl "https://api.parseapi.com/phone/555-0100" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "phone": null,
  "valid": false,
  "country": null,
  "type": null,
  "state": null,
  "state_name": null,
  "national": null,
  "international": null
}

Response fields

phone: Normalized number (+ country code, no spaces), or null if invalid
valid: Number is valid
country: ISO 3166-1 alpha-2 country
type: mobile | landline | toll_free | unknown, what the numbering plan says. The network's word (voip) lives on /carrier
state: State/province code from the area code (NANP), else null
state_name: State/province name from the area code (NANP), else null
national: National formatting
international: International formatting

Questions? Email