# States, Provinces and Administrative Subdivisions

ISO subdivision identifiers, names, types and parent relationships across countries and territories.

## Contents

| File | Records | Format |
|---|---:|---|
| records.json | 5,046 | JSON array |

The download contains the populated data, a field dictionary, source metadata, reuse terms, a change log and file digests. It contains no scripts, libraries, executables or conversion tools.

## Coverage

Every subdivision record in the retrieved iso-codes table. Administrative levels and categories differ between countries; this is not a harmonized level-1-only geography or a list of all municipalities.

## Sources and dates

- [Debian iso-codes, via its Sailfish OS mirror](https://raw.githubusercontent.com/sailfishos-mirror/iso-codes/main/data/iso_3166-2.json): retrieved snapshot; source hash recorded. Retrieved 2026-09-08T02:02:39.677395+00:00.

## Read the data

JSON tables are arrays of records. GeoJSON files are FeatureCollections, with data fields under each feature’s properties. `data-dictionary.json` defines the fields, units, nulls and observed types. `metadata.json` supplies primary keys and source hashes. Preserve identifiers as text and distinguish missing values from zero.

## Example record

This is an actual record from the data. For map layers, the example shows properties; the downloaded GeoJSON also contains the complete geometry.

```json
{
  "code": "AD-02",
  "name": "Canillo",
  "type": "Parish"
}
```

## Reuse terms

LGPL-2.1-or-later. Copyright 2016 Dr. Tobias Quathamer and iso-codes contributors. Data field selection and packaging modified by Arcomm on 2026-09-08.

[Publisher terms](https://github.com/sailfishos-mirror/iso-codes/blob/main/REUSE.toml). License notices are included where supplied.

## Tracking changes

Compare by code on upstream releases. Preserve withdrawn records in a new revision and record changed names separately from changed identifiers.

This publication is a snapshot. No automatic refresh is scheduled. New imports must preserve their source version, retrieval date and hashes, then publish a new Arcomm revision.

## Download

[Download the file](/files/794190c011541f26e921304eafb2859316d9cb692554f0f76f904c17aaa1a5c2)

SHA-256: `794190c011541f26e921304eafb2859316d9cb692554f0f76f904c17aaa1a5c2`

Size: 69452 bytes.

## Revisions

[Revision history](/agent/docs/administrative-subdivisions/history)