Caller names for your app

Caller ID
lookup API

Put a name beside the number.

Add the listed caller name to call screens, support queues and contact records. Send a North American +1 number. Get its CNAM listing as JSON.

Get startedExplore the API

100 free Caller ID lookups a month.

Example caller display

FEDEX

+18004633339

Complete API example

GET /caller/+18004633339

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

One number. Four useful fields.

A name your
interface can use.

The caller name arrives beside the normalized number, validity and country. Explore complete examples for each input.

Look up the listed name

Send an international phone number. Receive its normalized number, validity, country and listed caller name.

Request

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

Example response

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

Caller name listings

The listed name.
Ready to display.

Keep the caller listing beside the number in your app. Business names, personal names and generic labels come back as stored.

Use the number you have
Send +1 and ten digits, or a national number with a country hint. Formatting is normalized in the answer.
Keep a useful fallback
Show the number when caller is null. Names vary by number and listing availability.

North American +1 numbers

These countries and territories share the +1 numbering plan. A listed caller name is not available for every number.

  • 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

Results are cached between checks. Caller listings provide display context, not proof of who is calling.

From the first request to your app

Your call screen.
Your API key.

Look up the number from your server and put the listing where your team needs it. Keep secret keys on your server.

HTTP, SDKs and MCP

Copy a request above. Follow the reference for phone formats, complete responses and errors. Use an SDK in your language or connect through MCP.

Bulk Phone

Add names
to your contact list.

Upload a CSV or spreadsheet. Select Caller ID and keep your original columns alongside the results.

Preview a phone list

  1. Preview the results

    See how Caller ID fits beside your phone numbers.

  2. Review the quote

    See the exact file price before you pay.

  3. Download your file

    Take the results back to your contact workflow.

Before you build.

What is CNAM?

CNAM is the caller name listing used for caller ID. It may be a business name, a personal name or a generic label. ParseAPI returns the listing as stored, commonly in uppercase and up to 15 characters.

Which phone formats can I send?

Use an international number such as +18004633339. For a national number, pass a two-letter country code, such as /caller/8004633339?country=US. Spaces, dashes and parentheses are accepted. URL-encode the number in your request.

What does valid mean?

valid describes the phone number format and numbering plan. A caller name is a display label. It does not verify the person calling, ownership, reachability or consent to contact them.

What if caller is null?

Show the phone number when a name is unavailable. null can mean no listed name, a number outside +1 or an incomplete lookup. The response does not distinguish those causes.

How fresh is the name?

Results are cached between checks. Caller listings can change, and an update may take time to appear. Use the name as display context and keep the phone number alongside it.

How are Caller ID lookups counted?

Caller ID has its own monthly allowance. A completed lookup for a valid +1 number uses one Caller ID unit, including cached results and a completed lookup with no name. An incomplete lookup, invalid input or a number outside +1 uses no Caller ID unit. Plans shows included quantities and additional rates.

Can I look up a list of numbers?

Upload a CSV or spreadsheet to Bulk Phone and select Caller ID. Preview the results and review the exact quote before paying.

Can I also get the carrier or line status?

Use Carrier for the serving network and line type, or Live status for assignment and reachability at the last network check. They use the same API key and have separate lookup allowances.

Caller ID API pricing

Start with a name.
Choose your capacity.

Caller ID has its own monthly lookup allowance. Your plan also includes API requests across ParseAPI products.

Free

Start with a free API key.

Room to grow

Choose your capacity on Plans.

Additional lookups follow your plan's rate and on-demand settings.

Get startedCompare plans