📞US Area Codes
Look up any US telephone area code to find the state or territory it serves, or list every area code in a given state. Covers all 404 NANP codes in use, including overlays.
Worked examples
What state is 415?
GET /api/v1/databases/area-codes?code=415
Result: Area code 415 — California
All California codes
GET /api/v1/databases/area-codes?state=California&limit=15
Result: 15 area codes — California
What state is 212?
GET /api/v1/databases/area-codes?code=212
Result: Area code 212 — New York
Machine API (x402)
$0.001 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/databases/area-codes?code=415 HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "databases/area-codes",
"input": {"code":"415"},
"result": { "value": 415, "answer": "Area code 415 — California" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Every North American Numbering Plan area code in use — 404 of them, including overlays — mapped to its US state or territory. Look up a code to see where a caller is from, or list all codes for a state. Every area code also has its own page.
Frequently asked questions
Do overlay codes appear separately?
Yes — overlay codes (two codes serving the same region) are listed as distinct entries, each mapped to its state.
Does this cover Canada and the Caribbean?
The dataset focuses on US area codes. Canadian and Caribbean NANP codes are planned for a future expansion.