Referensi API

Wilayah

API Wilayah Indonesia berisi 38 provinsi, 514 kabupaten/kota, 7.285 kecamatan, dan 83.762 desa/kelurahan dengan kode wilayah Kemendagri. Setiap level punya endpoint list dan detail, plus pencarian nama lintas level, sehingga dropdown alamat bertingkat bisa dibangun tanpa memelihara dataset sendiri.

Data per · Sumber: Kepmendagri 2025 (transkripsi cahyadsn/wilayah)

Endpoint utama
GET https://use.apiindonesia.id/api/v1/wilayah/provinsi
Jumlah endpoint
12
Autentikasi
Header x-api-key (buat gratis di dashboard)
Harga
2 kredit (Rp2) per request sukses; request gagal gratis
Format
JSON (REST), contoh cURL, JavaScript, Python
Ringkasan Produk

Apa yang Anda dapat dari API ini

Data wilayah administratif Indonesia dari tingkat provinsi hingga kelurahan/desa, lengkap dengan kode wilayah, kode pos, dan koordinat. Semua endpoint list mendukung paginasi.

Cakupan
12

endpoint siap pakai dalam produk ini, dengan respons JSON dan pola error yang konsisten.

Akses
API key

Bisa dicoba dengan bonus 3.000 kredit saat daftar, lalu dipakai di production lewat satu API key API Indonesia.

Contoh resource
https://use.apiindonesia.id/api/v1/wilayah/provinsi

Mengembalikan daftar seluruh provinsi di Indonesia.

Kapan API ini layak dipakai?

API Wilayah cocok saat aplikasi Anda perlu struktur alamat Indonesia yang rapi: provinsi, kabupaten/kota, kecamatan, sampai kelurahan atau desa. Dataset ini berguna untuk checkout, onboarding, pencarian cabang, area layanan, dan analisis wilayah tanpa menaruh daftar alamat statis di frontend.

Butuh dropdown alamat bertingkat yang konsisten di web, mobile, dan admin panel.

Butuh kode wilayah untuk menghubungkan data pengguna dengan laporan internal.

Butuh koordinat dasar untuk pencarian lokasi atau estimasi area layanan.

Untuk validasi alamat legal, API ini sebaiknya dipakai bersama aturan bisnis Anda sendiri. Data wilayah memberi struktur, bukan bukti domisili seseorang.

Contoh skenario produk

Bagian ini membedakan halaman produk dari dokumentasi. Dokumentasi menjawab cara memanggil endpoint; halaman ini menjawab kenapa endpoint tersebut masuk akal untuk fitur Anda.

  • E-commerce & logistik: dropdown alamat bertingkat (provinsi → desa) saat checkout atau input alamat pengiriman.
  • Fintech & KYC: validasi domisili nasabah terhadap kode wilayah resmi Kemendagri.
  • Riset & pemerintahan: analisis data berbasis wilayah administratif tanpa perlu maintain dataset sendiri.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/wilayah/provinsi?page=1&per_page=20" \
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "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
  }
}

Jelajahi datanya

Artikel Terkait

Harga 2 kredit (Rp2) per request sukses; request gagal gratis. Bonus 3.000 kredit sekali saat daftar, tanpa kartu kredit dan tanpa jatah bulanan.

Pertanyaan seputar API Wilayah

Berapa jumlah wilayah yang tersedia di API Wilayah?

Data mencakup 38 provinsi, 514 kabupaten/kota, 7.285 kecamatan, dan 83.762 desa/kelurahan, dengan kode wilayah Kemendagri.

Bagaimana membuat dropdown alamat bertingkat?

Ambil provinsi dari GET /api/v1/wilayah/provinsi, lalu turunannya lewat /provinsi/{id}/kabupaten, /kabupaten/{id}/kecamatan, dan /kecamatan/{id}/kelurahan. Data kelurahan sudah menyertakan kode pos.

Bisakah mencari wilayah berdasarkan nama?

Bisa. GET /api/v1/wilayah/search?q=... mencari nama di semua level sekaligus (minimal 2 karakter), dan field level menunjukkan apakah hasilnya provinsi, kabupaten/kota, kecamatan, atau desa.

Apakah ada contoh data yang bisa diunduh tanpa API key?

Ada. Daftar 38 provinsi dan 514 kabupaten/kota tersedia sebagai file JSON gratis di apiindonesia.id/data/provinsi.json dan apiindonesia.id/data/kabupaten-kota.json. Kecamatan dan desa tersedia lewat API.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik