Subdivisions

ISO 3166-2 subdivisions of 200 countries — states, provinces, regions and the departments or counties inside them — searchable by name or code. From Unicode CLDR 48.2.

Provenance

Source: Unicode Common Locale Data Repository (CLDR)
Effective version: 48.2
Retrieved: 2026-09-23
Refresh cadence: Twice a year, on each CLDR release
Licence: Unicode License V3. Copyright © 2019-2025 Unicode, Inc. Redistribution permitted provided the copyright and permission notice accompany copies or associated documentation. Read the licence
Attribution: Unicode CLDR 48.2, © Unicode, Inc., Unicode License V3

Field schema

5,227 items, across 3 hierarchy levels: country, subdivision, sub_subdivision.

country: 200
subdivision: 3,571
sub_subdivision: 1,456

Every field this dataset’s items carry
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": "AZ-BAB",
  "displayValue": "Babek",
  "description": "Azerbaijan › Nakhchivan AR",
  "aliases": [
    "AZ-BAB",
    "Babek"
  ],
  "metadata": {
    "code": "AZ-BAB",
    "country": "AZ",
    "level": "sub_subdivision"
  },
  "ancestors": [
    {
      "value": "AZ",
      "displayValue": "Azerbaijan"
    },
    {
      "value": "AZ-NX",
      "displayValue": "Nakhchivan AR"
    }
  ]
}

Query it

/v1/query?key=YOUR_PUBLISHABLE_KEY&q=babek

The 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 Subdivisions as JSON.

API reference: query