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 lookup uses included units and overage. 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"
}

This lookup uses included units and overage. 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("+442079460958");
console.log(result);

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

Example response
{
  "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