CNAM API

Authentication

Send your key as a bearer token. Keys start with wc_live_. Request a key.

Authorization: Bearer wc_live_...

Look up a number

GET https://whoscall.ing/v1/cnam/{number}

{number} is any NANP number: 10 digits, or 11 starting with 1. A leading + and punctuation are ignored (URL-encode them).

curl -H "Authorization: Bearer $WHOSCALLING_KEY" \
  https://whoscall.ing/v1/cnam/2025550123

Response

200 OK
{
  "number": "+12025550123",  // E.164
  "cnam": "EXAMPLE CALLER",  // null if the carrier has no name on file
  "cached": false            // true if answered from our 24 h cache
}

Errors

400Not a valid NANP number. Not billed.
401Missing, malformed or revoked key.
502Upstream lookup failed. Not billed; retry.

Errors are JSON: {"error": "..."}. There are no rate limits.

Billing

Every 200 is one billable lookup, including a null name: $0.007 each for the first 100,000 in a calendar month (UTC), then $0.005. Usage per key is on your account page. Billing questions: sales@whoscall.ing.