# GetAreaCode.com

> Lookup tool for US telephone area codes, the Caribbean and Pacific countries and territories inside the +1 numbering plan (the four US island territories included), and the special-use codes: the city and state a code serves, its time zone, overlays, carriers and prefixes, the counties and cities inside its boundary, and how often numbers showing it are reported for unwanted calls. Built from US Census, NANPA and FTC data. Canadian area codes are not covered.

This is the markdown twin of https://getareacode.com/ — the same site with no navigation, styling or JavaScript. It covers 374 US geographic area codes, 25 international NANP codes and 39 special-use codes, each with its own page and markdown twin. Data last updated: August 2026.

**When to use this site**

- Use this site when a question hangs on a +1 (NANP) area code: which city, state or country a code serves, its time zone, whether it overlays other codes and which, which carriers hold prefixes in it, which counties and cities sit inside its boundary, and how often numbers showing it are reported for unwanted calls.
- Use it in the other direction too: which area codes serve a given US city or state, whether a 3-digit code exists and is in service, and whether it is geographic, toll-free, premium-rate or another special-use range.
- How to call it: fetch https://getareacode.com/<code>.md for one code (for example https://getareacode.com/213.md), fetch https://getareacode.com/states/<abbr>.md for a state, or GET https://getareacode.com/llms/?query=<question> to ask in words. These same pages are also served as markdown from their own URLs under `Accept: text/markdown`.
- Do not use it to identify who owns a phone number, where a caller is right now, or anything else about an individual number — no per-number data exists here. Canadian area codes are not covered.

## Query endpoints

- [Plain-text query endpoint](https://getareacode.com/llms/?query=213): `GET /llms/?query=<question>` returns the parts of the per-code documents that answer the question. Takes `query` (an area code, a phone number, a city, a state, a NANP country, a special-use purpose, or a code plus the part you want — "213 carriers"), `tokens` (budget, default 4000, max 30000) and `limit` (documents, default 3, max 10). A bare request returns the full instructions.
- [JSON query endpoint](https://getareacode.com/llms/json/?query=213): the same result as JSON, same parameters.
- [Retrieval is lexical, not semantic](https://getareacode.com/llms/): matching runs on codes, city names, state names, country names and special-use purposes — the same rules as the site's own search — so a name or a number reaches an answer where a paraphrase may not.

## Core pages

- [Home](https://getareacode.com/): search by area code, city or state.
- [All area codes](https://getareacode.com/area-codes/): every code in one table, filterable by state and time zone.
- [Area codes by state](https://getareacode.com/states/): the 50 states plus the District of Columbia and Puerto Rico.
- [Methodology and data sources](https://getareacode.com/methodology/): how every figure on the site is produced, and what each one counts.
- [About](https://getareacode.com/about/): what the site does and does not hold.
- [Reverse phone lookup](https://getareacode.com/reverse-lookup/): a waitlist — the tool does not exist yet, and no per-number data is published today.
- [Contact](https://getareacode.com/contact/): corrections and data questions.
- [Terms](https://getareacode.com/terms/): terms of use.
- [Privacy](https://getareacode.com/privacy/): privacy policy.

## Machine-readable index

- [llms.txt](https://getareacode.com/llms.txt): one line per page — every code, every state — plus the conventions behind the site's figures. Start there.
- [llms-full.txt](https://getareacode.com/llms-full.txt): every per-code document in one file, about 4.9 MB — fetch it only when you want the whole corpus.
