GET /caller/{number}
Caller ID API
Pass a phone number. Lookup the CNAM, the name a phone screen shows.
Example response
GET /caller/+18004633339
{
"phone": "+18004633339",
"valid": true,
"country": "US",
"caller": "FEDEX"
}100 free lookups a month. Additional lookups are priced by your plan.
What comes back.
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
1
Pass a phone number
Dashes, parentheses, or 10 digits. It comes back normalized and valid.
2
Get the caller ID
The name a phone screen shows, verbatim. A number with no record answers null.
3
A list when you have one
Drop a phone CSV. Caller ID is a toggle on the quote. See the exact price before you pay.
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
- 25
- countries & territories
- 15
- characters max
- 100
- free lookups a month
- On demand
- see Plans for rates
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 North American number uses one lookup. Free includes 100 a month. Additional lookups are priced by your plan. A number with no record still uses one, and a valid number outside +1 answers caller: null free.
SPEED
How long /caller takes.
Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.
US
90ms
EU
251ms
APAC
342ms
LatAm
249ms
ME
393ms
Put a name to the number.
North American caller ID. Checks have their own allowance.
Start includes 1M API requests a month for $20/mo.
500 caller ID lookups included per month.
Make your first request.
One key works across the APIs. Copy a request in your language and get JSON back.
curl "https://api.parseapi.com/caller/+18004633339" \
-H "X-API-Key: YOUR_API_KEY"// Example response · 200{"phone": "+18004633339", "valid": true, "country": "US", "caller": "FEDEX" }
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 month. See Plans for additional lookup rates. A number with no record still uses one. A valid number outside +1 answers caller: null free.
- Who serves the number?
- GET /carrier returns the carrier, the real line type, and a burner flag.
- Can I check assignment and reachability?
- GET /hlr returns assignment and reachability at the last network check. Results are cached.
- Just need validation?
- GET /phone validates and formats any number. 245 countries and regions.
- Can I run a list?
- Drop a phone CSV on /bulk. Caller ID is a toggle on the quote, priced per unique North American number.
Phone APIs
Phone
Valid, formatted, plus the line type. Optional numbering-plan detail.
Carrier
Who serves it. Real line type, including voip. Burner flag.
Caller ID
The name a phone screen shows.
Live status
Assignment and reachability at the last network check.
Have a list?
Drop a phone CSV. Caller ID is a toggle on the quote. See your exact price before paying.
Drop a CSV, Excel, or Numbers file
or choose a file