API — Ukraine (UA)

27 oblasts, 139 raions, 1,769 hromadas.

Endpoints

GET /api/v1/countries/ua.json
Full dataset — all levels, all records
GET /api/v1/ua/oblast.json
All 27 oblasts (Область)
GET /api/v1/ua/raion.json
All 139 raions (Район)
GET /api/v1/ua/hromada.json
All 1,769 hromadas (Громада)
GET /api/v1/ua/oblast/{slug}.json
Single oblast with children

Quick Start

JavaScript

fetch('https://api.openadmindata.org/api/v1/countries/ua.json')
  .then(r => r.json())
  .then(data => {
    const levels = data.meta.levels.map(l => l.name_en);
    console.log('Ukraine:', levels.join(' → '));
    
    console.log(data.data.oblast.length, 'oblasts');
  });

Python

import requests
data = requests.get('https://api.openadmindata.org/api/v1/countries/ua.json').json()
oblasts = data['data']['oblast']
print(f"Ukraine: {len(oblasts)} oblasts")

cURL

curl -s https://api.openadmindata.org/api/v1/ua/oblast.json | jq '.count'

Schema

Each entity record contains:

FieldTypeDescription
idstringUnique identifier
name_localstringName in local script
name_enstringEnglish / romanized name
slugstringURL-safe slug
latnumberLatitude (WGS84)
lonnumberLongitude (WGS84)
parent_idstring?Parent entity ID (null for top level)
parent_name_localstring?Parent name in local script
parent_name_enstring?Parent English name
postal_codestring?Postal code (deepest level only, where available)