Referensi API

Kode Pos

Direktori 83.000+ data kode pos per desa/kelurahan se-Indonesia lengkap dengan hierarki wilayah dari provinsi hingga desa, memakai kode wilayah Kemendagri. Data statis bersumber dari dataset resmi. Pemetaan ke kode wilayah BPS belum tersedia: parameter bps_* sudah ada, tetapi datanya masih kosong.

Endpoint utama
GET https://use.apiindonesia.id/api/v1/kodepos
Jumlah endpoint
4
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

Direktori 83.000+ data kode pos per desa/kelurahan se-Indonesia lengkap dengan hierarki wilayah dari provinsi hingga desa, memakai kode wilayah Kemendagri. Data statis bersumber dari dataset resmi. Pemetaan ke kode wilayah BPS belum tersedia: parameter bps_* sudah ada, tetapi datanya masih kosong.

Cakupan
4

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/kodepos

Mengembalikan daftar kode pos dengan paginasi dan kode wilayah Kemendagri yang eksplisit. Kolom dan filter kode BPS tersedia untuk 96% data (pemetaan resmi SIG BPS 2025). Sebagian kecil desa baru belum punya pasangan BPS; catatan: (belum tersedia).

Kapan API ini layak dipakai?

API Kode Pos membantu produk yang perlu menyambungkan kode pos dengan hierarki wilayah Indonesia. Cocok untuk checkout, label pengiriman, validasi alamat, pencarian area, dan segmentasi pelanggan.

Form alamat harus mengisi kode pos otomatis setelah pengguna memilih wilayah.

Support perlu mencari wilayah saat pelanggan hanya memberi kode pos.

Produk logistik perlu menyamakan kode pos dengan provinsi, kota, kecamatan, dan desa.

Satu wilayah bisa punya relasi kode pos yang tidak selalu sederhana. Desain UI agar pengguna tetap bisa memilih opsi yang benar.

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: auto-isi kode pos saat pelanggan memilih alamat pengiriman.
  • Fintech: validasi kesesuaian kode pos dengan alamat domisili saat KYC.
  • Aplikasi pencarian alamat: cari wilayah berdasarkan kode pos atau sebaliknya.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/kodepos?kabupaten_id=3273" \\
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "data": [
    {
      "id": "kp_3273011001",
      "village_code": "3273011001",
      "village_name": "Sukarasa",
      "district_code": "327301",
      "district_name": "Sukasari",
      "regency_code": "3273",
      "regency_name": "Kota Bandung",
      "province_code": "32",
      "province_name": "Jawa Barat",
      "postal_code": "40151",
      "kode_pos": "40151",
      "bps_village_code": null,
      "kemendagri_village_code": "3273011001",
      "source_version": "legacy-v1",
      "crosswalk_source_version": null,
      "is_active": 1
    }
  ],
  "meta": {
    "total": 151,
    "page": 1,
    "per_page": 20,
    "total_pages": 8
  }
}

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 Kode Pos

Berapa banyak data kode pos yang tersedia?

Ada 83.000+ data kode pos, satu per desa/kelurahan, lengkap dengan hierarki provinsi sampai desa dan kode wilayah Kemendagri.

Bagaimana mencari wilayah dari kode pos?

Gunakan GET /api/v1/kodepos/lookup?kode_pos=40151 untuk pencocokan persis, atau /kodepos/search?q=... untuk mencari lewat nama desa atau angka kode pos.

Apakah kode wilayah BPS sudah tersedia?

Belum. Parameter dan field bps_* sudah ada di API, tetapi data pemetaan BPS masih kosong, jadi untuk saat ini gunakan kode Kemendagri.

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