Caller ID API

The registered caller ID (CNAM) for a number.

The registered caller ID (CNAM) for a phone number. Pass +18004633339 and get back caller, the name a phone screen shows. The record ships verbatim from the CNAM database, all caps and 15 characters max.

CNAM covers North American numbers. Other countries return caller: null. Junk answers valid: false as a 200, never a 404.

Lookup

GET

api.parseapi.com/caller/{number}

Caller ID for a number. Optional ?country= (ISO2) for national formats

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

{
  "phone": "+18004633339",
  "valid": true,
  "country": "US",
  "caller": "FEDEX"
}

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

{
  "phone": "+442079460958",
  "valid": true,
  "country": "GB",
  "caller": 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
caller: Registered caller ID from the CNAM database, or null when there is no record

Counts against your plan's monthly caller ID allowance. Free includes 100. Each lookup on a North American number uses one. A number with no record still uses one.

Questions? Email