NANP area-code lookup API

Resolve a North American Numbering Plan area code (3 digits) to the primary region/state/province it serves, its country, and its primary IANA timezone — covering US states, Canadian provinces, and Caribbean NANP members. Answers 'what area code is 415', 'where is 416 located', 'what timezone is the 808 area code', 'which province uses 604'.

Price$0.01per request

MethodPOST

Route/v1/ref/area-code

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refarea-codenanpphonetelephoneregiontimezonedialing

API URLhttps://x402.hexl.dev/v1/ref/area-code

Integration docs

Example request

{
  "code": "415"
}

Example response

{
  "code": "415",
  "found": true,
  "region": "California",
  "country": "US",
  "timezone": "America/Los_Angeles",
  "plan": "NANP"
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": [
        "string",
        "number"
      ],
      "examples": [
        "415",
        416
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}