← Blog
Artikel

Database Kode Pos Indonesia 2026: 83.762 Desa/Kelurahan via API (JSON dan Ekspor CSV)

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.

Database kode pos Indonesia 2026 di API Indonesia berisi 83.762 baris, satu baris untuk setiap desa/kelurahan, mencakup 9.052 kode pos unik di 38 provinsi, 514 kabupaten/kota, dan 7.285 kecamatan. Setiap baris menyimpan kode wilayah Kemendagri sampai level desa, jadi kode pos bisa langsung digabung dengan data alamat. Data ini kami cek langsung dari database produksi pada 29 Oktober 2026.

Ringkasnya: Anda bisa mengambilnya per kecamatan, per kabupaten, atau mencari dengan kata kunci lewat REST API (JSON). Belum ada file unduhan CSV/SQL resmi, tapi seluruh data bisa diekspor lewat API dengan sekitar 838 request, masih di bawah bonus 3.000 kredit untuk akun baru.

Fakta singkat

Item Nilai
Jumlah baris (desa/kelurahan) 83.762
Kode pos unik 9.052
Provinsi / kabupaten-kota / kecamatan 38 / 514 / 7.285
Kode wilayah Kemendagri (provinsi 2 digit s.d. desa 10 digit)
Kode wilayah BPS Belum tersedia (kolom bps_* bernilai null)
Format JSON lewat REST API
Snapshot data Kemendagri compatibility snapshot, sinkron 18 September 2026

Kenapa jumlah baris jauh lebih banyak dari kode pos unik? Karena satu kode pos biasanya dipakai beberapa desa/kelurahan sekaligus. Di Jawa Tengah misalnya ada 8.563 desa/kelurahan tetapi hanya 706 kode pos unik.

Jumlah kode pos per provinsi

Kode Provinsi Desa/kelurahan Kode pos unik
11 Aceh 6.500 350
12 Sumatera Utara 6.110 585
13 Sumatera Barat 1.265 211
14 Riau 1.862 212
15 Jambi 1.585 175
16 Sumatera Selatan 3.259 343
17 Bengkulu 1.513 155
18 Lampung 2.651 335
19 Kepulauan Bangka Belitung 393 68
21 Kepulauan Riau 419 87
31 DKI Jakarta 267 231
32 Jawa Barat 5.957 758
33 Jawa Tengah 8.563 706
34 DI Yogyakarta 438 92
35 Jawa Timur 8.494 791
36 Banten 1.552 207
51 Bali 716 71
52 Nusa Tenggara Barat 1.166 159
53 Nusa Tenggara Timur 3.442 397
61 Kalimantan Barat 2.145 219
62 Kalimantan Tengah 1.571 157
63 Kalimantan Selatan 2.016 173
64 Kalimantan Timur 1.038 137
65 Kalimantan Utara 482 63
71 Sulawesi Utara 1.839 204
72 Sulawesi Tengah 2.017 206
73 Sulawesi Selatan 3.059 367
74 Sulawesi Tenggara 2.285 241
75 Gorontalo 729 106
76 Sulawesi Barat 648 81
81 Maluku 1.235 160
82 Maluku Utara 1.185 149
91 Papua 999 158
92 Papua Barat 824 126
93 Papua Selatan 690 83
94 Papua Tengah 1.208 149
95 Papua Pegunungan 2.627 272
96 Papua Barat Daya 1.013 102

Sumber: database produksi API Indonesia, tabel kode pos per desa/kelurahan, dihitung 29 Oktober 2026. Kode pos unik dihitung per provinsi, jadi totalnya tidak sama dengan 9.052 nasional.

Ambil data lewat API

Semua kode pos di satu kabupaten/kota (contoh Kota Bandung, kode 3273):

curl "https://use.apiindonesia.id/api/v1/kodepos?kabupaten_id=3273&per_page=100" \
  -H "x-api-key: YOUR_API_KEY"
{
  "data": [
    {
      "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",
      "kode_pos": "40151",
      "bps_village_code": null,
      "kemendagri_village_code": "3273011001"
    }
  ]
}

Cari berdasarkan nama desa atau angka kode pos:

curl "https://use.apiindonesia.id/api/v1/kodepos/search?q=40151" \
  -H "x-api-key: YOUR_API_KEY"

Filter lain yang tersedia: provinsi_id, kecamatan_id, kode_pos, dan kemendagri_village_code. Detail ada di halaman produk API Kode Pos dan dokumentasinya.

Ekspor ke CSV sendiri

Kalau Anda butuh file CSV untuk database internal, ambil per provinsi dengan per_page=100 lalu tulis ke file. Seluruh 83.762 baris butuh sekitar 838 request, atau 1.676 kredit.

import { writeFileSync } from 'node:fs';

const KEY = process.env.API_INDONESIA_KEY;
const rows = ['provinsi,kabupaten,kecamatan,desa,kode_desa,kode_pos'];

async function ambilProvinsi(provinsiId) {
  for (let page = 1; ; page++) {
    const url = `https://use.apiindonesia.id/api/v1/kodepos?provinsi_id=${provinsiId}&per_page=100&page=${page}`;
    const r = await fetch(url, { headers: { 'x-api-key': KEY } });
    const { data, meta } = await r.json();
    for (const d of data) {
      rows.push([d.province_name, d.regency_name, d.district_name, d.village_name, d.village_code, d.kode_pos]
        .map((v) => `"${String(v ?? '').replace(/"/g, '""')}"`).join(','));
    }
    if (page >= meta.total_pages) break;
  }
}

await ambilProvinsi('61'); // Kalimantan Barat
writeFileSync('kodepos-61.csv', rows.join('\n'));

Yang belum ada

  • Pemetaan ke kode BPS. Kolom bps_province_code sampai bps_village_code sudah ada di skema, tetapi isinya masih null karena data crosswalk BPS belum diimpor. Kalau Anda butuh kode BPS, jangan isi dengan menyalin kode Kemendagri; keduanya tidak selalu sama. Penjelasannya ada di artikel kode wilayah Kemendagri vs BPS.
  • File unduhan siap pakai. Untuk saat ini, ekspor lewat API seperti contoh di atas.

FAQ

Berapa jumlah kode pos di Indonesia? Di data kami ada 9.052 kode pos unik untuk 83.762 desa/kelurahan, per snapshot 18 September 2026.

Apakah satu desa bisa punya lebih dari satu kode pos? Di dataset ini setiap desa/kelurahan memiliki satu kode pos. Sebaliknya, satu kode pos sering dipakai beberapa desa.

Apakah data kode pos ini bisa dipakai untuk form checkout? Bisa. Ambil kecamatan dari API Wilayah, lalu tampilkan kode pos desa/kelurahan dari API Kode Pos. Contohnya ada di artikel API kode pos Indonesia untuk cari alamat.

Berapa biayanya? Akun baru mendapat 3.000 kredit sekali. Tiap request sukses memakai 2 kredit (Rp2), dan request gagal tidak dihitung.

Mulai sekarang

Daftar di dashboard.apiindonesia.id/register untuk API key dan bonus 3.000 kredit, cukup untuk mengekspor seluruh database kode pos sekali.

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