U.S. states and territories
The 50 U.S. states, the District of Columbia and the six island areas, searchable by name, USPS abbreviation or FIPS code. Published by the U.S. Census Bureau.
Provenance
- Source
- U.S. Census Bureau
- Effective version
- 2020
- Retrieved
- 2026-09-23
- Refresh cadence
- Decennial; rarely changes
- Licence
- U.S. Government work. Not subject to copyright protection in the United States (17 U.S.C. §105). The Census Bureau requests citation rather than imposing licence terms. Read the licence
- Attribution
- Source: U.S. Census Bureau, 2020 Census FIPS codes
Field schema
57 items.
| Field | Type | Meaning |
|---|---|---|
| value | string | The canonical, unique value — what a query resolves to. |
| displayValue | string | The locale-resolved label a suggestion renders. |
| description | string, optional | Free-text detail shown beside the item. NAICS uses it for the ancestor breadcrumb; not every dataset sets it. |
| parentSourceId | string, optional | The parent item in the source’s own key space, for a hierarchical dataset. |
| hierarchyLevel | string, optional | Which level of the hierarchy this item sits at. |
| displayOrder | integer | Curated display order, distinct from relevance rank (`DEC-LIST-004`). |
| aliases | string[] | Alternate spellings that resolve to this item at no extra runtime KV read (`DEC-ALIAS-001`). |
| metadata | object | Dataset-specific fields — e.g. NAICS’s `code`/`level`/`trilateral`, or a country’s `alpha2`/`alpha3`/`numeric`. |
A worked item
{
"value": "NV",
"displayValue": "Nevada",
"aliases": [
"NV",
"32",
"Nevada"
],
"metadata": {
"usps": "NV",
"fips": "32",
"kind": "state"
}
}Query it
/v1/query?key=YOUR_PUBLISHABLE_KEY&q=nevadaThe publishable key above is a public, browser-safe identifier — never a secret.
Download
The licence above permits redistributing the compiled list as a file. Download U.S. states and territories as JSON.