REGIONAL API

API Wilayah Indonesia — Provinsi, Kota, Kabupaten, Kecamatan, Kelurahan & Kode Pos

Akses provinsi, kota, kabupaten, kecamatan, dan kelurahan di seluruh Indonesia dengan API Wilayah Indonesia. Termasuk search advanced dan lookup kode pos. Langganan mulai Rp 19.000/bulan (Starter 5.000 hits), 0 points per hit. Dataset ini bagian dari katalog API data Indonesia.

API Wilayah Indonesia: Data Regional Lengkap untuk Logistik, Checkout, dan Analitik

API Wilayah Indonesia (Indonesia Regional API) menyediakan data resmi yang selalu diperbarui untuk provinsi, kota/kabupaten, kecamatan, kelurahan, dan kode pos. Layanan ini ideal untuk autofill checkout e-commerce, cakupan logistik, validasi alamat, pemetaan, dan dashboard BI.

Dengan API ini, Anda mendapatkan JSON yang dapat diprediksi, respons cepat, dan pembaruan otomatis saat terjadi perubahan administratif. Tidak perlu lagi impor CSV atau pembaruan manual—aplikasi Anda tetap terkini untuk setiap wilayah Indonesia.

📊 Database Terlengkap di Indonesia

38
Provinsi

514
Kota/Kabupaten

7.277
Kecamatan

89.525
Kelurahan

81.574
Kode Pos

✨ Database Terlengkap di Indonesia

📍

Hierarki Lengkap

Provinsi → kota → kecamatan → kelurahan dengan kode pos.

⚡

Cepat & Andal

Respons JSON latensi rendah, pengiriman berbasis CDN.

🧾

Langganan Per Produk

Hierarchy provinsi–kelurahan, search advanced & lookup kode pos dalam satu langganan.

🔁

Pembaruan Otomatis

Tidak perlu sinkronisasi manual—data diperbarui saat wilayah berubah.

Pilih Tier Sesuai Volume Wilayah

Langganan bulanan per produk dengan kuota hits yang jelas. Starter Rp 19.000 (5.000 hits), Pro Rp 49.000 (25.000 hits), Business Rp 99.000 (100.000 hits).

Starter

Rp 19.000

/ bulan • 5.000 hits

  • • Provinsi hingga kelurahan
  • • Pencarian advanced
  • • 0 points per hit

Subscribe Starter

Business

Rp 99.000

/ bulan • 100.000 hits

  • • Semua fitur Pro
  • • High-volume production
  • • Priority support

Subscribe Business

Catatan: Langganan berlaku per produk. Tidak ada biaya per hit selama dalam kuota tier bulanan. Subscribe dari dashboard.

Dokumentasi API Wilayah Indonesia

Endpoint REST yang jelas untuk provinsi, kota, kabupaten, kecamatan, kelurahan, dan kode pos Indonesia. Pelajari cara menggunakan layanan ini dengan mudah. Dokumentasi lengkap mencakup semua endpoint yang tersedia.

🔐 Authentication: Semua request memerlukan header x-api-co-id dengan API key Anda. Dapatkan API key gratis di dashboard.

GET
{{base-url}}/regional/indonesia/provinces

Daftar semua provinsi di Indonesia. Query parameters: name (optional) untuk filter by name, page (optional) untuk pagination.

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "11",
      "name": "ACEH"
    },
    {
      "code": "12",
      "name": "SUMATERA UTARA"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 34,
    "total_page": 1
  }
}

GET
{{base-url}}/regional/indonesia/provinces/:code

Dapatkan provinsi tertentu berdasarkan kode (2 digits, contoh: 11 untuk Aceh).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": {
    "code": "11",
    "name": "ACEH"
  }
}

GET
{{base-url}}/regional/indonesia/provinces/:code/regencies

Dapatkan semua kabupaten/kota dalam provinsi tertentu. Query parameters: name (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "1101",
      "name": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 23,
    "total_page": 1
  }
}

GET
{{base-url}}/regional/indonesia/regencies

Daftar semua kabupaten/kota di Indonesia. Query parameters: province_code (optional), name (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "1101",
      "name": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 514,
    "total_page": 6
  }
}

GET
{{base-url}}/regional/indonesia/regencies/:code

Dapatkan kabupaten/kota tertentu berdasarkan kode (4 digits, contoh: 1101).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": {
    "code": "1101",
    "name": "KABUPATEN SIMEULUE",
    "province_code": "11",
    "province": "ACEH"
  }
}

GET
{{base-url}}/regional/indonesia/regencies/:code/districts

Dapatkan semua kecamatan dalam kabupaten/kota tertentu. Query parameters: name (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "110101",
      "name": "TEUPAH SELATAN",
      "regency_code": "1101",
      "regency": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 10,
    "total_page": 1
  }
}

GET
{{base-url}}/regional/indonesia/districts

Daftar semua kecamatan di Indonesia. Query parameters: regency_code (optional), name (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "110101",
      "name": "TEUPAH SELATAN",
      "regency_code": "1101",
      "regency": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 7277,
    "total_page": 73
  }
}

GET
{{base-url}}/regional/indonesia/districts/:code

Dapatkan kecamatan tertentu berdasarkan kode (6 digits, contoh: 110101).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": {
    "code": "110101",
    "name": "TEUPAH SELATAN",
    "regency_code": "1101",
    "regency": "KABUPATEN SIMEULUE",
    "province_code": "11",
    "province": "ACEH"
  }
}

GET
{{base-url}}/regional/indonesia/districts/:code/villages

Dapatkan semua kelurahan dalam kecamatan tertentu. Query parameters: name (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "1101010001",
      "name": "LATIUNG",
      "district_code": "110101",
      "district": "TEUPAH SELATAN",
      "regency_code": "1101",
      "regency": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH",
      "postal_codes": ["23891"]
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 18,
    "total_page": 1
  }
}

GET
{{base-url}}/regional/indonesia/villages

Daftar semua kelurahan di Indonesia. Query parameters: district_code (optional), name (optional), postal_code (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "1101010001",
      "name": "LATIUNG",
      "district_code": "110101",
      "district": "TEUPAH SELATAN",
      "regency_code": "1101",
      "regency": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH",
      "postal_codes": ["23891"]
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 89525,
    "total_page": 896
  }
}

GET
{{base-url}}/regional/indonesia/villages/:code

Dapatkan kelurahan tertentu berdasarkan kode (10 digits, contoh: 1101010001) dengan informasi hierarki lengkap.

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": {
    "code": "1101010001",
    "name": "LATIUNG",
    "district_code": "110101",
    "district": "TEUPAH SELATAN",
    "regency_code": "1101",
    "regency": "KABUPATEN SIMEULUE",
    "province_code": "11",
    "province": "ACEH",
    "postal_codes": ["23891"]
  }
}

GET
{{base-url}}/regional/indonesia/postal-codes

Daftar semua kode pos di Indonesia. Query parameters: village_code (optional), postal_code (optional), page (optional).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "id": 1,
      "postal_code": "23891",
      "village_code": "1101010001",
      "village": "LATIUNG",
      "district_code": "110101",
      "district": "TEUPAH SELATAN",
      "regency_code": "1101",
      "regency": "KABUPATEN SIMEULUE",
      "province_code": "11",
      "province": "ACEH"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 81574,
    "total_page": 816
  }
}

GET
{{base-url}}/regional/indonesia/postal-codes/:postal_code

Cari kelurahan berdasarkan kode pos (5 digits, contoh: 12210).

Example Response
{
  "is_success": true,
  "message": "Success",
  "data": [
    {
      "code": "3174050001",
      "name": "GROGOL UTARA",
      "district_code": "317405",
      "district": "KEBAYORAN LAMA",
      "regency_code": "3174",
      "regency": "KOTA JAKARTA SELATAN",
      "province_code": "31",
      "province": "DKI JAKARTA",
      "postal_codes": ["12210"]
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 1,
    "total_page": 1
  }
}

GET
{{base-url}}/regional/indonesia/search?query=jakarta

Pencarian advanced across semua tipe data regional (province, regency, district, village) by name atau postal code. Query parameters: query (required), type (optional: province, regency, district, village), page (optional).

Example Response
{
  "status": "success",
  "timestamp": "2025-12-25 08:55:38",
  "result": [
    {
      "province_code": "31",
      "province": "DKI JAKARTA",
      "city_code": "3174",
      "city": "KOTA JAKARTA SELATAN",
      "district_code": "317405",
      "district": "KEBAYORAN LAMA",
      "village_code": "3174050001",
      "village": "GROGOL UTARA",
      "postal_code": "12210"
    }
  ],
  "paging": {
    "page": 1,
    "size": 100,
    "total_item": 1,
    "total_page": 1
  }
}

Pertanyaan Umum tentang API Wilayah Indonesia

Temukan jawaban untuk pertanyaan umum seputar API wilayah Indonesia, penggunaan, dan integrasi.

Apa itu API Wilayah Indonesia?
▼

API Wilayah Indonesia menyediakan database struktur administratif Indonesia: 38 provinsi, 514 kota/kabupaten, 7.277 kecamatan, dan 89.525 kelurahan. Semua endpoint termasuk pencarian advanced dan lookup kode pos menggunakan model langganan per produk dengan 0 points per hit dalam kuota tier.

Bagaimana cara menggunakan API Wilayah Indonesia?
▼

Untuk menggunakan layanan ini, Anda perlu mendaftar dan mendapatkan API key terlebih dahulu di dashboard. Setelah mendapatkan API key, sertakan dalam header request sebagai x-api-co-id: YOUR_API_KEY. Anda dapat mengakses berbagai endpoint seperti /regional/indonesia/provinces untuk mendapatkan daftar provinsi, atau /regional/indonesia/regencies untuk mendapatkan daftar kabupaten/kota. Semua endpoint mengembalikan data dalam format JSON dengan pagination support.

Berapa biaya penggunaan API ini?
▼

API ini menggunakan model langganan per produk dengan 0 points per hit. Pilih tier Starter (Rp 19.000 / 5.000 hits), Pro (Rp 49.000 / 25.000 hits), atau Business (Rp 99.000 / 100.000 hits) dari dashboard.

Apakah ada free tier?
▼

Produk ini tidak menyediakan free tier bulanan. Berlangganan tier Starter untuk memulai, atau pilih All-Access Bundle jika Anda membutuhkan banyak produk API sekaligus.

Apa saja query parameters yang tersedia?
▼

Setiap endpoint mendukung berbagai query parameters untuk filtering dan pagination: name (filter by name, case-insensitive partial match), page (pagination, default: 1), province_code (filter regencies by province), regency_code (filter districts by regency), district_code (filter villages by district), postal_code (filter villages by postal code). Pagination size fixed di 100 items per page dan tidak dapat dikonfigurasi. Untuk Search API, parameter query (required) dan type (optional: province, regency, district, village).

Seberapa lengkap data yang tersedia?
▼

Database kami adalah yang terlengkap di Indonesia dengan 38 provinsi, 514 kota/kabupaten, 7.277 kecamatan, 89.525 kelurahan, dan 81.574 kode pos. Data mencakup seluruh hierarki administratif: provinsi → kabupaten/kota → kecamatan → kelurahan, beserta kode pos untuk setiap wilayah. Data diperbarui secara otomatis ketika terjadi perubahan administratif di Indonesia, sehingga aplikasi Anda selalu terkini tanpa pembaruan manual.

Apa saja yang bisa saya lakukan dengan layanan ini?
▼

Layanan ini dapat digunakan untuk berbagai keperluan: E-commerce: autofill form checkout dan validasi alamat pengiriman. Logistik: pemetaan cakupan dan routing. CRM & Analytics: integrasi dengan sistem CRM dan dashboard analitik bisnis. Validasi: validasi alamat dan kode pos. Search: pencarian advanced across all types by name atau postal code. API ini mendukung hierarki lengkap dari provinsi hingga kelurahan beserta kode pos.

Bagaimana format response API?
▼

Semua endpoint mengembalikan response dalam format JSON dengan struktur konsisten: is_success (boolean), message (string), data (array atau object), dan paging (object dengan page, size, total_item, total_page) untuk endpoint yang mendukung pagination. Response selalu dalam format yang dapat diprediksi dan mudah diintegrasikan. Untuk Search API, format sedikit berbeda dengan field status, timestamp, dan result.

Berapa lama waktu respons layanan ini?
▼

Layanan ini dirancang dengan performa tinggi dan menggunakan CDN untuk pengiriman yang cepat. Waktu respons biasanya di bawah 200ms untuk sebagian besar request. Rate limiting diterapkan untuk menjaga kualitas layanan untuk semua pengguna.

Apakah ada limit untuk pagination?
▼

Ya, pagination size fixed di 100 items per page dan tidak dapat dikonfigurasi. Setiap response yang mendukung pagination akan menyertakan object paging dengan informasi: page (current page), size (items per page, selalu 100), total_item (total items), dan total_page (total pages). Gunakan parameter page untuk navigasi ke halaman berikutnya.

Bergabung dengan 8.000+ pengguna yang sudah mengandalkan API kami untuk operasional bisnis.

8.000+
Pengguna
100+
Bisnis
8jt+
Panggilan API
99,9%
Uptime SLA

Dipercaya oleh 100+ bisnis di berbagai industri

Dari instansi pemerintah, teknologi, dan pendidikan sampai kesehatan dan telekomunikasi, mencakup 8 sektor industri di seluruh Indonesia.

Mulai Gunakan API Wilayah Indonesia Sekarang

Luncurkan pengalaman siap Indonesia lebih cepat. Langganan mulai Rp 19.000/bulan — 0 points per hit dalam kuota tier.

Dapatkan API Key Anda

Ditinjau oleh CTO Api.co.idDiperbarui 3 Oktober 2026
Scroll to Top