ready-to-use endpoints in this product, with JSON responses and consistent error handling.
The Indonesia Regions API covers 38 provinces, 514 regencies/cities, 7,285 districts and 83,762 villages, keyed by Kemendagri region codes. Each level has list and detail endpoints plus a cross-level name search, so you can build cascading address dropdowns without maintaining your own dataset.
Data as of · Source: Kepmendagri 2025 (cahyadsn/wilayah transcription)
Indonesian administrative region data from province down to village level, complete with region codes, postal codes, and coordinates. All list endpoints support pagination.
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.
https://use.apiindonesia.id/api/v1/wilayah/provinsiReturns a list of all provinces in Indonesia.
The Regions API fits apps that need a clean Indonesian address structure: provinces, regencies/cities, districts, down to villages. It works well for checkout, onboarding, branch search, service areas, and region analysis without shipping static address lists in the frontend.
You need cascading address dropdowns that stay consistent across web, mobile, and admin panels.
You need region codes to connect user records with internal reporting.
You need basic coordinates for location search or service-area estimates.
For legal address validation, pair this API with your own business rules. Region data gives structure, not proof of someone’s domicile.
This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.
curl "https://use.apiindonesia.id/api/v1/wilayah/provinsi?page=1&per_page=20" \
-H "x-api-key: YOUR_API_KEY"{
"data": [
{
"id": "32",
"code": "32",
"name": "JAWA BARAT",
"alt_name": "Jawa Barat",
"lat": -6.914744,
"lng": 107.609811,
"is_active": 1
}
],
"meta": {
"total": 38,
"page": 1,
"per_page": 20,
"total_pages": 2
}
}Browse the data
Kode Kemendagri dan kode BPS berbeda untuk wilayah yang sama. Contoh nyata dari tabel relasi BPS, kapan memakai masing-masing, dan cara menghindari salah gabung data.
Database kode pos Indonesia 2026: 83.762 desa/kelurahan, 9.052 kode pos unik, kode Kemendagri, jumlah per provinsi, dan cara ekspor ke CSV lewat API.
91.241 batas wilayah Indonesia dalam format GeoJSON: 38 provinsi, 514 kabupaten/kota, 7.285 kecamatan, dan 83.404 desa. Lengkap dengan tutorial peta Leaflet dan cek titik dengan turf.js.
It covers 38 provinces, 514 regencies/cities, 7,285 districts and 83,762 villages, keyed by Kemendagri region codes.
Load provinces from GET /api/v1/wilayah/provinsi, then each child level with /provinsi/{id}/kabupaten, /kabupaten/{id}/kecamatan and /kecamatan/{id}/kelurahan. Village records already include the postal code.
Yes. GET /api/v1/wilayah/search?q=... searches names across all levels at once (minimum 2 characters), and the level field tells you whether each result is a province, regency/city, district or village.
Yes. The 38 provinces and 514 regencies/cities are free JSON files at apiindonesia.id/data/provinsi.json and apiindonesia.id/data/kabupaten-kota.json. Districts and villages are available through the API.