How to use Carrier Lookup

The carrier originally assigned a US number block: company name, operating company number (OCN), rate center and state, from the public NANPA central office code and thousands-block reports, with the report date. Porting is not reflected (ported: unknown), so a number moved to another carrier still shows its original one. NANPA data has no carrier category, so line type is only a hint from the carrier name. Canada and the Caribbean are not covered.

Send these fields in the JSON body of the request.

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

1 credit per lookup (numbers outside the covered numbering plan areas are free).

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/carrier-lookup with your API key.

1curl -X POST https://YOUR_API_HOST/v1/carrier-lookup \
2  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"phone":"+12024561111"}'

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

• A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
• When the lookup finds nothing it returns found: false and costs 0 credits.
• Invalid input and errors are never charged.
• The API allows 200 requests per 10 seconds per key.