~48.7K KOATUU records
~32K KATOTTG records
96.4% KOATUU ↔ KATOTTG
100% KATOTTG coordinates
download Download code GitHub lab_profile KOATUU Quality Report lab_profile KATOTTG Quality Report
Zenodo · ORCID

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

merge_type

Unified Structure

Both classifiers (KOATUU and KATOTTG) normalized into a single 11-column schema — code, name, level, region, district, council, full address, category.

history

Historical Codes

Includes both active and cancelled codes. Critical for working with data that uses legacy KOATUU codes (e.g., vehicle registry).

compare_arrows

Cross-references

29,092 KATOTTG settlements matched to KOATUU codes — 96.4% coverage. Enables easy transition between classifiers.

my_location

Geocoordinates

100% of KATOTTG records (31,993) and 72.6% of KOATUU records (35,378 of 48,706) have lat/lon coordinates.

account_tree

Full Hierarchy

5 levels of administrative hierarchy: oblast → raion → hromada/council → settlement → subdivision. Parent codes for tree building.

storage

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

Total records 48 706
With coordinates 35 378 (72.6%)

KATOTTG

Total records 31 993
With coordinates 31 993 (100%)
Matched to KOATUU 29 092 (96.4%)

table_chart Data Schema

KOATUU (koatuu.csv / .parquet)

ColumnTypeDescriptionExample
codeSTRINGKOATUU code (10-digit)0100000000
nameSTRINGAdministrative unit nameВінницька
levelINTHierarchy level (1–5)1
regionSTRINGOblast (region)Вінницька
districtSTRINGRaion (district)Вінницький
councilSTRINGCouncil / hromadaВінницька міська рада
full_addressSTRINGFull hierarchical addressВінницька / Вінницький / ...
parent_codeSTRINGParent unit code0510000000
categorySTRINGSettlement category codeМ
category_nameSTRINGCategory name in Ukrainianмісто
settlementSTRINGSettlement (additional)Вінниця
lat Paid subscriptionFLOATLatitude49.2328
lon Paid subscriptionFLOATLongitude28.4810

KATOTTG (katottg.csv / .parquet)

ColumnTypeDescriptionExample
codeSTRINGKATOTTG code (UA-prefix)UA05020010010075540
nameSTRINGAdministrative unit nameВінниця
levelINTHierarchy level (1–5)4
regionSTRINGOblast (region)Вінницька
districtSTRINGRaion (district)Вінницький
councilSTRINGCouncil / hromadaВінницька міська громада
full_addressSTRINGFull hierarchical addressВінницька / Вінницький / ...
parent_codeSTRINGParent unit codeUA05020010000013043
categorySTRINGSettlement category codeМ
category_nameSTRINGCategory name in Ukrainianмісто
settlementSTRINGSettlement (additional)Вінниця
koatuu Paid subscriptionSTRINGCorresponding KOATUU code0510100000
lat Paid subscriptionFLOATLatitude49.2328
lon Paid subscriptionFLOATLongitude28.4810
info

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

CodeCategoryCount
С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

Mykhailo Klimnyk

Mykhailo Klimnyk

Head of Data, AUTOMOTO

format_quote How to Cite

Klimnyk, M. (2026). UA Administrative Codes: Ukrainian Administrative-Territorial Classification Codes (KOATUU & KATOTTG). https://doi.org/10.5281/zenodo.18863103

When 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

What are UA Administrative Codes?

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.

How is this dataset different from others?

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.

How many records does the dataset contain?

The dataset contains ~48,700 KOATUU records and ~32,000 KATOTTG records, covering all administrative hierarchy levels — from oblasts to settlements.

Are there coordinates for 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.