API — Iraq (IQ)
18 governorates, 101 districts, 294 sub-districts.
Endpoints
GET
/api/v1/iq/governorate/{slug}.json
Single governorate with children
Quick Start
JavaScript
fetch('https://openadmindata.org/api/v1/countries/iq.json')
.then(r => r.json())
.then(data => {
const levels = data.meta.levels.map(l => l.name_en);
console.log('Iraq:', levels.join(' → '));
console.log(data.data.governorate.length, 'governorates');
});Python
import requests
data = requests.get('https://openadmindata.org/api/v1/countries/iq.json').json()
governorates = data['data']['governorate']
print(f"Iraq: {len(governorates)} governorates")cURL
curl -s https://openadmindata.org/api/v1/iq/governorate.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) |