The North American caller ID registry. The name a phone screen shows, stored in all caps, 15 characters max. We ship the record as stored.

Any +1 number, including 10-digit and punctuation. North American area codes pick the country.

What does a lookup cost?

One caller ID lookup from the monthly allowance per North American number. Free includes 100. A number with no record still uses one.

Drop a phone CSV on /bulk. Caller ID is a toggle on the quote, priced per unique number.

GET /caller/{number}

Caller ID API

Pass a number. Get the name a phone screen shows.

(800) 463-3339FEDEX

+442079460958caller: null

555-0100valid: false

phone

Normalized number (+ country code, no spaces), or null if invalid

valid

Number is valid

country

ISO 3166-1 alpha-2 country

caller

Registered caller ID from the CNAM database, or null when there is no record

Pass a number

Dashes, parentheses, or 10 digits. It comes back normalized and valid.

Get the caller ID

The name a phone screen shows, verbatim. A number with no record answers null.

A list when you have one

Drop a phone CSV. Caller ID is a toggle on the quote. A cent a lookup.

100 free a month.

A North American number is one lookup.

Have a list?

Drop a phone CSV. Caller ID is a toggle on the quote. A cent a lookup, $5 minimum.

Drop a CSV, Excel, or Numbers file

.csv, .xlsx, .xls, .numbers, .tsv, or a text list

Bulk phone validation

25
countries & territories: 15
characters max

Look up the name a phone screen shows. (800) 463-3339, 8004633339, and +18004633339 all work. You get back caller, all caps, 15 characters, exactly as stored.

That record comes from CNAM, the North American caller ID registry. Each call uses one lookup from your plan's monthly allowance. Free includes 100. A number with no record still uses one.

RESPONSE

$ curl "https://api.parseapi.com/caller/+18004633339" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~16ms · USA
{
  "phone": "+18004633339",
  "valid": true,
  "country": "US",
  "caller": "FEDEX"
}

Response fields

phone: Normalized number (+ country code, no spaces), or null if invalid
valid: Number is valid
country: ISO 3166-1 alpha-2 country
caller: Registered caller ID from the CNAM database, or null when there is no record

QUESTIONS

What is CNAM?: The North American caller ID registry. The name a phone screen shows, stored in all caps, 15 characters max. We ship the record as stored.
What numbers work?: Any +1 number, including 10-digit and punctuation. North American area codes pick the country.
What does a lookup cost?: One caller ID lookup from the monthly allowance per North American number. Free includes 100. A number with no record still uses one.
Can I run a list?: Drop a phone CSV on /bulk. Caller ID is a toggle on the quote, priced per unique number.

SPEED

How long a lookup takes.

16ms

17ms

APAC

67ms

LatAm

18ms

127ms

See live status →

Coverage

Twenty-five countries and territories that share +1.

United States
Canada
American Samoa
Anguilla
Antigua and Barbuda
Bahamas
Barbados
Bermuda
British Virgin Islands
Cayman Islands
Dominica
Dominican Republic
Grenada
Guam
Jamaica
Montserrat
Northern Mariana Islands
Puerto Rico
Saint Kitts and Nevis
Saint Lucia
Saint Vincent and the Grenadines
Sint Maarten
Trinidad and Tobago
Turks and Caicos
US Virgin Islands

Get started Docs