Search by task, endpoint, field, or error.

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.

LookupCopy link

GET /caller/{number}API Explorer ↗

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

Parameters

numberstring · path · required

Phone number (E.164 preferred)

countrystring · query · optional

Default region for national formats without a leading +

Example

Request

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

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.caller("+18004633339");
console.log(result);
Example response
{
  "phone": "+18004633339",
  "valid": true,
  "country": "US",
  "caller": "FEDEX"
}
Open in API Explorer ↗

Response fields

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