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
| 400 | Not a valid NANP number. Not billed. |
| 401 | Missing, malformed or revoked key. |
| 502 | Upstream 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.