Search by task, endpoint, field, or error.

← Docs

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
Explore
Parameters 2
numberstring · path · required

Phone number (E.164 preferred)

countrystring · query · optional

Default region for national formats without a leading +

This metered lookup uses its included allowance or enabled on-demand billing. Copy the example to run it with your key.

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

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.caller("+18004633339");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

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

Response fields

phonestring or null
Normalized number (+ country code, no spaces), or null if invalid
validboolean
Number is valid
countrystring or null
ISO 3166-1 alpha-2 country
callerstring or null
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