Phone Number API

Validate and format a number. 246 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 last-observed network status .

ValidateCopy link

GET /phone/{number}API Explorer ↗

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

Parameters

numberstring · path · required

Supplied check value. Invalid values return HTTP 200 with valid false.

Length: 0 to 4096 characters

countrystring · query · optional

Default region for national formats without a leading +

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.phone("+14155552671");
console.log(result);
Example responsePaid plan
{
  "phone": "+14155552671",
  "valid": true,
  "country": "US",
  "type": "unknown",
  "national": "(415) 555-2671",
  "international": "+1 415 555 2671",
  "state": "CA",
  "state_name": "California",
  "timezone": "America/Los_Angeles"
}

Response fields

phoneLink to phonestring or null
Normalized number (+ country code, no spaces), or null if invalid
validLink to validboolean
Number is valid
countryLink to countrystring or null
ISO 3166-1 alpha-2 country
typeLink to typestring or null
mobile | landline | toll_free | unknown, what the numbering plan says. The network's word (voip) lives on /carrier
nationalLink to nationalstring or null
National formatting
internationalLink to internationalstring or null
International formatting

Included dataCopy link

Numbering-plan state and timezone, when known. Included automatically on paid plans in API 2.2. Existing accounts retain their current profile access.

Paid plan fields

stateLink to statestring or null
State/province code from the area code (NANP), else null
state_nameLink to state_namestring or null
State/province name from the area code (NANP), else null
timezoneLink to timezonestring or null
IANA timezone id from the numbering plan, else null. Zone of the number, not the handset