API Kode Pos Indonesia: Cari Kode Pos berdasarkan Alamat secara Instan

Form checkout e-commerce dan aplikasi pengiriman butuh validasi kode pos yang cepat dan akurat agar alamat pengiriman tidak salah kirim. API Kode Pos dari API Indonesia memetakan kode pos ke seluruh hierarki wilayah — provinsi, kabupaten/kota, kecamatan, hingga kelurahan/desa — dan mendukung pencarian bebas berdasarkan nama tempat atau angka kode pos itu sendiri.

Daftar Endpoint

Base URL: https://use.apiindonesia.id/api/v1/kodepos

Method	Endpoint	Keterangan
GET	/?provinsi_id=&kabupaten_id=&kecamatan_id=	Daftar kode pos, bisa difilter per level wilayah
GET	/search?q=	Cari berdasarkan nama kelurahan atau angka kode pos
GET	/:id	Detail satu entri kode pos

Contoh Request

# Cari kode pos berdasarkan nama daerah
curl "https://use.apiindonesia.id/api/v1/kodepos/search?q=kemang" \
  -H "x-api-key: aip_live_xxx"

# Daftar kode pos dalam satu kecamatan
curl "https://use.apiindonesia.id/api/v1/kodepos?kecamatan_id=3273010" \
  -H "x-api-key: aip_live_xxx"

async function cariKodePos(keyword) {
  const res = await fetch(
    `https://use.apiindonesia.id/api/v1/kodepos/search?q=${encodeURIComponent(keyword)}`,
    { headers: { 'x-api-key': process.env.API_INDONESIA_KEY } }
  );
  const { data } = await res.json();
  return data; // array { village_name, district_name, regency_name, postal_code, ... }
}

import requests

res = requests.get(
    "https://use.apiindonesia.id/api/v1/kodepos/search",
    params={"q": "40123"},
    headers={"x-api-key": "aip_live_xxx"},
)
hasil = res.json()["data"]

Contoh Response

{
  "data": [
    {
      "id": "kp_3273010001",
      "village_code": "3273.01.0001",
      "village_name": "KEBON KAWUNG",
      "district_name": "SUKAJADI",
      "regency_name": "KOTA BANDUNG",
      "province_name": "JAWA BARAT",
      "postal_code": "40161"
    }
  ]
}

Kasus Pakai

• Autocomplete alamat di form checkout — tampilkan saran kelurahan dan kode pos saat pengguna mengetik nama daerah.
• Validasi ongkir & zona pengiriman — kelompokkan kode pos ke kecamatan/kabupaten untuk perhitungan tarif pengiriman.
• Aplikasi logistik & ekspedisi — verifikasi kecocokan alamat tujuan dengan kode pos yang diinput.
• Sinkron dengan alamat wilayah — gunakan village_code/district_code yang sama dengan API Wilayah untuk konsistensi data alamat.

FAQ

Apakah bisa mencari langsung dari angka kode pos? Bisa, endpoint /search?q= mencocokkan baik nama kelurahan maupun angka kode pos.

Apakah satu kelurahan hanya punya satu kode pos? Sebagian besar kelurahan memiliki satu kode pos utama; gunakan village_code sebagai kunci unik jika Anda perlu menyimpan referensi ke wilayah tertentu.

Bagaimana jika kelurahan tertentu belum punya data kode pos? Entri tanpa kode pos tidak akan muncul di hasil endpoint ini — gunakan API Wilayah sebagai sumber data wilayah yang lebih lengkap.

Mulai Sekarang

Dapatkan API key gratis di dashboard.apiindonesia.id/register dan lihat detail lengkap di docs.apiindonesia.id.