API — Ukraine (UA)
27 oblasts, 139 raions, 1,769 hromadas.
Endpoints
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:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier |
name_local | string | Name in local script |
name_en | string | English / romanized name |
slug | string | URL-safe slug |
lat | number | Latitude (WGS84) |
lon | number | Longitude (WGS84) |
parent_id | string? | Parent entity ID (null for top level) |
parent_name_local | string? | Parent name in local script |
parent_name_en | string? | Parent English name |
postal_code | string? | Postal code (deepest level only, where available) |