# Countries and Territories

Current country and territory names with ISO alpha-2, alpha-3 and numeric identifiers.

## Contents

| File | Records | Format |
|---|---:|---|
| records.json | 249 | 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

All entries in the retrieved iso-codes ISO 3166-1 table. A code assignment is not a statement about sovereignty or recognition.

## Sources and dates

- [Debian iso-codes, via its Sailfish OS mirror](https://raw.githubusercontent.com/sailfishos-mirror/iso-codes/main/data/iso_3166-1.json): retrieved snapshot; source hash recorded. Retrieved 2026-09-08T02:02:39.334488+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
{
  "alpha_2": "AW",
  "alpha_3": "ABW",
  "flag": "🇦🇼",
  "name": "Aruba",
  "numeric": "533"
}
```

## 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 alpha_2 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/a22bb4802a0a11c64df6f1e0915d5fdafb833b33dd2feb2fe30a99fc2ec0c6fe)

SHA-256: `a22bb4802a0a11c64df6f1e0915d5fdafb833b33dd2feb2fe30a99fc2ec0c6fe`

Size: 19468 bytes.

## Revisions

[Revision history](/agent/docs/world-country-codes/history)