UA Administrative Codes (KOATUU & KATOTTG)
The most comprehensive public compilation of Ukrainian administrative-territorial classification codes in machine-readable format with coordinates and cross-references.
info About the dataset
UA Administrative Codes is a public reference compilation of Ukrainian administrative-territorial classification codes in machine-readable format. The dataset covers two systems: KOATUU (legacy, established 1997) and KATOTTG (current, active since 2020).
This is the most comprehensive public dataset that unifies both classifiers in a single structure, includes both active and cancelled codes, and contains 96.4% cross-references between KOATUU and KATOTTG.
Data is compiled from scattered government sources, consolidated into a convenient format, and enriched with geocoordinates for all KATOTTG settlements (100%) and most KOATUU entries (72.6%).
verified Dataset Features
Unified Structure
Both classifiers (KOATUU and KATOTTG) normalized into a single 11-column schema — code, name, level, region, district, council, full address, category.
Historical Codes
Includes both active and cancelled codes. Critical for working with data that uses legacy KOATUU codes (e.g., vehicle registry).
Cross-references
29,092 KATOTTG settlements matched to KOATUU codes — 96.4% coverage. Enables easy transition between classifiers.
Geocoordinates
100% of KATOTTG records (31,993) and 72.6% of KOATUU records (35,378 of 48,706) have lat/lon coordinates.
Full Hierarchy
5 levels of administrative hierarchy: oblast → raion → hromada/council → settlement → subdivision. Parent codes for tree building.
Parquet & CSV
Data available in Apache Parquet (Snappy compression) and CSV for universal compatibility.
source Sources
KOATUU Classifier (DK 014-97)
State Statistics Service of Ukraine
KATOTTG Codifier
Ministry for Communities and Territories Development of Ukraine
bar_chart Statistics
KOATUU
KATOTTG
table_chart Data Schema
KOATUU (koatuu.csv / .parquet)
| Column | Type | Description | Example |
|---|---|---|---|
code | STRING | KOATUU code (10-digit) | 0100000000 |
name | STRING | Administrative unit name | Вінницька |
level | INT | Hierarchy level (1–5) | 1 |
region | STRING | Oblast (region) | Вінницька |
district | STRING | Raion (district) | Вінницький |
council | STRING | Council / hromada | Вінницька міська рада |
full_address | STRING | Full hierarchical address | Вінницька / Вінницький / ... |
parent_code | STRING | Parent unit code | 0510000000 |
category | STRING | Settlement category code | М |
category_name | STRING | Category name in Ukrainian | місто |
settlement | STRING | Settlement (additional) | Вінниця |
lat Paid subscription | FLOAT | Latitude | 49.2328 |
lon Paid subscription | FLOAT | Longitude | 28.4810 |
KATOTTG (katottg.csv / .parquet)
| Column | Type | Description | Example |
|---|---|---|---|
code | STRING | KATOTTG code (UA-prefix) | UA05020010010075540 |
name | STRING | Administrative unit name | Вінниця |
level | INT | Hierarchy level (1–5) | 4 |
region | STRING | Oblast (region) | Вінницька |
district | STRING | Raion (district) | Вінницький |
council | STRING | Council / hromada | Вінницька міська громада |
full_address | STRING | Full hierarchical address | Вінницька / Вінницький / ... |
parent_code | STRING | Parent unit code | UA05020010000013043 |
category | STRING | Settlement category code | М |
category_name | STRING | Category name in Ukrainian | місто |
settlement | STRING | Settlement (additional) | Вінниця |
koatuu Paid subscription | STRING | Corresponding KOATUU code | 0510100000 |
lat Paid subscription | FLOAT | Latitude | 49.2328 |
lon Paid subscription | FLOAT | Longitude | 28.4810 |
The core 11 columns are free. Columns lat, lon and koatuu (for KATOTTG) are available via paid subscription. Contact us for details.
category Settlement Categories
| Code | Category | Count |
|---|---|---|
С | village (selo) | ~33 600 |
Щ | settlement (selyshche) | ~1 370 |
Т | urban-type settlement (SMT) | ~930 |
М | city (misto) | ~460 |
Р | city district | ~120 |
menu_book Documentation & Links
person Author
format_quote How to Cite
Klimnyk, M. (2026). UA Administrative Codes: Ukrainian Administrative-Territorial Classification Codes (KOATUU & KATOTTG). https://doi.org/10.5281/zenodo.18863103When using this data, you must credit Mykhailo Klimnyk as the author and include a reference to the DOI.
apps Other AUTOMOTO Products
Ready to work with the data?
Download the free Ukrainian administrative codes dataset or contact us for access to extended fields with coordinates.
FAQ
This is the most comprehensive public compilation of Ukrainian administrative-territorial classification codes, including KOATUU (legacy, since 1997) and KATOTTG (current, since 2020) classifiers in machine-readable Parquet and CSV formats.
This is the only dataset that unifies both classifiers in a single structure, includes historical and cancelled codes, has 96.4% cross-references between KOATUU and KATOTTG, and 100% coordinates for KATOTTG settlements.
The dataset contains ~48,700 KOATUU records and ~32,000 KATOTTG records, covering all administrative hierarchy levels — from oblasts to settlements.
Yes, 100% of KATOTTG records (31,993) and 72.6% of KOATUU records (35,378 of 48,706) have geocoordinates (lat/lon). Coordinates are available via paid subscription.
