API Documentation

Static JSON API. No authentication, no rate limits. CORS enabled. Served from CDN.

Base URL

https://openadmindata.org/api/v1/

Endpoint Builder

Select a country and level to build an API URL.

Endpoints

GET /api/v1/countries.json
List all countries with metadata
Example: /api/v1/countries.json
GET /api/v1/countries/{code}.json
Full country data (all levels)
Example: /api/v1/countries/bn.json
GET /api/v1/{country}/{level}.json
All entities at a level
Example: /api/v1/bn/district.json
GET /api/v1/{country}/{level}/{slug}.json
Entity detail + children
GET /api/v1/stats.json
Aggregate statistics
Example: /api/v1/stats.json

Examples

List all countries

curl https://openadmindata.org/api/v1/countries.json

Get Brunei data

fetch('https://openadmindata.org/api/v1/countries/bn.json')
  .then(r => r.json())
  .then(data => {
    console.log(data.meta.countryName.en); // "Brunei"
    console.log(data.data.district.length); // 4
  });

Python

import requests
data = requests.get('https://openadmindata.org/api/v1/countries/th.json').json()
provinces = data['data']['province']
print(f"{len(provinces)} provinces")

Response Format

All responses are JSON with UTF-8 encoding.

{
  "meta": {
    "country": "bn",
    "countryName": { "local": "Brunei Darussalam", "en": "Brunei" },
    "levels": [...],
    "stats": { "district": 4, "mukim": 42, "kampong": 438 }
  },
  "data": {
    "district": [
      { "id": "BN-BE", "name_local": "Belait", "name_en": "Belait", "lat": 4.392, "lon": 114.581 }
    ]
  }
}

Available Countries

CodeCountryLevelsRecordsAPI Docs
af Afghanistan 2 435 Endpoints & Examples →
dz Algeria 3 2,147 Endpoints & Examples →
ao Angola 3 718 Endpoints & Examples →
ag Antigua and Barbuda 2 125 Endpoints & Examples →
ar Argentina 3 2,930 Endpoints & Examples →
am Armenia 3 849 Endpoints & Examples →
az Azerbaijan 2 4,671 Endpoints & Examples →
bs Bahamas 2 381 Endpoints & Examples →
bh Bahrain 2 44 Endpoints & Examples →
bd Bangladesh 3 567 Endpoints & Examples →
bb Barbados 2 510 Endpoints & Examples →
bz Belize 2 468 Endpoints & Examples →
bj Benin 4 4,404 Endpoints & Examples →
bt Bhutan 2 225 Endpoints & Examples →
bo Bolivia 3 460 Endpoints & Examples →
bw Botswana 3 564 Endpoints & Examples →
br Brazil 2 5,599 Endpoints & Examples →
bn Brunei 3 484 Endpoints & Examples →
bf Burkina Faso 3 415 Endpoints & Examples →
bi Burundi 3 3,054 Endpoints & Examples →
kh Cambodia 3 1,887 Endpoints & Examples →
cm Cameroon 3 428 Endpoints & Examples →
cv Cape Verde 2 54 Endpoints & Examples →
cf Central African Republic 3 275 Endpoints & Examples →
td Chad 3 441 Endpoints & Examples →
cl Chile 3 417 Endpoints & Examples →
co Colombia 2 1,155 Endpoints & Examples →
km Comoros 3 75 Endpoints & Examples →
cr Costa Rica 3 583 Endpoints & Examples →
cu Cuba 2 184 Endpoints & Examples →
dj Djibouti 2 26 Endpoints & Examples →
dm Dominica 2 116 Endpoints & Examples →
do Dominican Republic 4 583 Endpoints & Examples →
cd DR Congo 3 709 Endpoints & Examples →
ec Ecuador 3 1,287 Endpoints & Examples →
eg Egypt 3 6,108 Endpoints & Examples →
sv El Salvador 3 328 Endpoints & Examples →
gq Equatorial Guinea 2 39 Endpoints & Examples →
er Eritrea 2 64 Endpoints & Examples →
sz Eswatini 2 59 Endpoints & Examples →
et Ethiopia 3 1,270 Endpoints & Examples →
fj Fiji 3 105 Endpoints & Examples →
ga Gabon 3 4,249 Endpoints & Examples →
gm Gambia 3 172 Endpoints & Examples →
ge Georgia 2 83 Endpoints & Examples →
gh Ghana 3 2,355 Endpoints & Examples →
gd Grenada 2 287 Endpoints & Examples →
gt Guatemala 2 364 Endpoints & Examples →
gn Guinea 3 382 Endpoints & Examples →
gw Guinea-Bissau 3 3,953 Endpoints & Examples →
gy Guyana 2 37 Endpoints & Examples →
ht Haiti 3 720 Endpoints & Examples →
hn Honduras 2 316 Endpoints & Examples →
hk Hong Kong 2 470 Endpoints & Examples →
id Indonesia 4 88,297 Endpoints & Examples →
ir Iran 2 460 Endpoints & Examples →
iq Iraq 3 413 Endpoints & Examples →
ci Ivory Coast 3 651 Endpoints & Examples →
jm Jamaica 3 920 Endpoints & Examples →
jo Jordan 3 863 Endpoints & Examples →
ke Kenya 3 1,787 Endpoints & Examples →
ki Kiribati 2 39 Endpoints & Examples →
kw Kuwait 2 170 Endpoints & Examples →
kg Kyrgyzstan 3 522 Endpoints & Examples →
la Laos 3 13,496 Endpoints & Examples →
lb Lebanon 3 1,644 Endpoints & Examples →
ls Lesotho 2 88 Endpoints & Examples →
lr Liberia 2 151 Endpoints & Examples →
ly Libya 4 1,294 Endpoints & Examples →
mg Madagascar 3 1,720 Endpoints & Examples →
mw Malawi 3 468 Endpoints & Examples →
my Malaysia 3 2,035 Endpoints & Examples →
mv Maldives 2 1,577 Endpoints & Examples →
ml Mali 4 1,470 Endpoints & Examples →
mh Marshall Islands 2 177 Endpoints & Examples →
mr Mauritania 3 316 Endpoints & Examples →
mu Mauritius 2 123 Endpoints & Examples →
mx Mexico 2 2,489 Endpoints & Examples →
fm Micronesia 2 79 Endpoints & Examples →
mn Mongolia 2 361 Endpoints & Examples →
ma Morocco 3 1,814 Endpoints & Examples →
mz Mozambique 3 581 Endpoints & Examples →
mm Myanmar 4 17,626 Endpoints & Examples →
na Namibia 2 121 Endpoints & Examples →
nr Nauru 1 14 Endpoints & Examples →
np Nepal 3 859 Endpoints & Examples →
ni Nicaragua 2 170 Endpoints & Examples →
ne Niger 3 341 Endpoints & Examples →
ng Nigeria 3 9,610 Endpoints & Examples →
kp North Korea 2 190 Endpoints & Examples →
om Oman 3 421 Endpoints & Examples →
pk Pakistan 3 744 Endpoints & Examples →
pw Palau 2 93 Endpoints & Examples →
ps Palestine 2 18 Endpoints & Examples →
pa Panama 3 683 Endpoints & Examples →
pg Papua New Guinea 3 435 Endpoints & Examples →
py Paraguay 2 268 Endpoints & Examples →
pe Peru 3 2,094 Endpoints & Examples →
ph Philippines 4 43,771 Endpoints & Examples →
qa Qatar 3 880 Endpoints & Examples →
cg Republic of the Congo 2 101 Endpoints & Examples →
rw Rwanda 3 451 Endpoints & Examples →
kn Saint Kitts and Nevis 2 133 Endpoints & Examples →
vc Saint Vincent and the Grenadines 2 97 Endpoints & Examples →
ws Samoa 2 54 Endpoints & Examples →
st Sao Tome and Principe 2 9 Endpoints & Examples →
sa Saudi Arabia 2 74 Endpoints & Examples →
sn Senegal 3 185 Endpoints & Examples →
sc Seychelles 3 39 Endpoints & Examples →
sl Sierra Leone 4 1,504 Endpoints & Examples →
sg Singapore 3 392 Endpoints & Examples →
sb Solomon Islands 3 243 Endpoints & Examples →
so Somalia 2 109 Endpoints & Examples →
za South Africa 4 4,666 Endpoints & Examples →
ss South Sudan 3 601 Endpoints & Examples →
lk Sri Lanka 4 14,416 Endpoints & Examples →
sd Sudan 2 208 Endpoints & Examples →
sr Suriname 2 72 Endpoints & Examples →
sy Syria 3 348 Endpoints & Examples →
tj Tajikistan 2 81 Endpoints & Examples →
tz Tanzania 3 3,844 Endpoints & Examples →
th Thailand 3 8,369 Endpoints & Examples →
tl Timor-Leste 3 520 Endpoints & Examples →
tg Togo 3 418 Endpoints & Examples →
to Tonga 3 194 Endpoints & Examples →
tt Trinidad and Tobago 2 415 Endpoints & Examples →
tn Tunisia 4 2,378 Endpoints & Examples →
tr Turkey 3 3,523 Endpoints & Examples →
tv Tuvalu 2 42 Endpoints & Examples →
ug Uganda 4 1,862 Endpoints & Examples →
ae United Arab Emirates 2 114 Endpoints & Examples →
uy Uruguay 2 671 Endpoints & Examples →
uz Uzbekistan 2 213 Endpoints & Examples →
vu Vanuatu 2 72 Endpoints & Examples →
ve Venezuela 3 1,493 Endpoints & Examples →
vn Vietnam 2 3,355 Endpoints & Examples →
ye Yemen 2 357 Endpoints & Examples →
zm Zambia 4 2,135 Endpoints & Examples →
zw Zimbabwe 3 2,062 Endpoints & Examples →

CORS & Caching

All API endpoints include:

Access-Control-Allow-Origin: *
Cache-Control: public, max-age=3600
Content-Type: application/json; charset=utf-8