API Kode Pos Indonesia — Gratis, Tanpa API Key

REST API publik untuk data kode pos dan wilayah administrasi Indonesia: 38 Provinsi514 Kab/Kota7.277 Kecamatan85.595 Desa/Kelurahan

📖 Dokumentasi interaktif · OpenAPI JSON · Rate limit 100 request/menit per IP

Cara pakai (contoh)

curl "https://kodepos.api.hizb.or.id/api/v1/postal-codes/10110"
curl "https://kodepos.api.hizb.or.id/api/v1/provinces?limit=5"
curl "https://kodepos.api.hizb.or.id/api/v1/villages?q=Gambir&limit=3"

Daftar endpoint

Method	Endpoint	Keterangan
GET	/api/v1/provinces	Daftar provinsi (`q`, `page`, `limit`)
GET	`/api/v1/provinces/:id`	Detail provinsi
GET	/api/v1/regencies	Kabupaten/kota (`province_id`, `q`)
GET	`/api/v1/regencies/:id`	Detail kabupaten/kota
GET	/api/v1/districts	Kecamatan (`regency_id`, `q`)
GET	`/api/v1/districts/:id`	Detail kecamatan
GET	/api/v1/villages	Desa/kelurahan (`district_id`, `postal_code`, `q`)
GET	`/api/v1/villages/:id`	Detail desa + hirarki wilayah
GET	/api/v1/postal-codes/:code	Cari desa berdasarkan kode pos
GET	/health	Status server

Pertanyaan umum (FAQ)

Apakah API ini gratis?

Ya, gratis tanpa API key. Cukup patuhi rate limit 100 request per menit per IP.

Dari mana datanya?

Dataset wilayah administrasi + kode pos Indonesia (38 provinsi, 514 kab/kota, 7.277 kecamatan, 85.595 desa/kelurahan). Response mencakup hirarki desa → kecamatan → kabupaten → provinsi.

Bagaimana format pagination?

Semua endpoint list memakai ?page=&limit= (maksimal 100) dan mengembalikan {data, meta:{page,limit,total}}.