Coverage
4
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
Directory of 83,000+ postal codes across Indonesia complete with regional hierarchy from province to village. Static data sourced from the official dataset.
Directory of 83,000+ postal codes across Indonesia complete with regional hierarchy from province to village. Static data sourced from the official dataset.
ready-to-use endpoints in this product, with JSON responses and consistent error handling.
Can be tested on the free tier, then used in production through one API Indonesia key.
https://use.apiindonesia.id/api/v1/kodeposReturns paginated postal codes with explicit BPS and Kemendagri administrative codes.
The Postal Code API supports products that need to connect postal codes with Indonesian region hierarchy. It fits checkout, shipping labels, address validation, area search, and customer segmentation.
Address forms must auto-fill postal codes after users choose a region.
Support teams need to find a region when customers only provide a postal code.
Logistics products need to match postal codes with province, city, district, and village.
Postal-code relationships are not always one-to-one. Design the UI so users can still choose the right option.
This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.
curl "https://use.apiindonesia.id/api/v1/kodepos?kabupaten_id=3273" \\
-H "x-api-key: aip_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"{
"data": [
{
"id": "kp_3273011001",
"village_code": "32.73.01.1001",
"village_name": "ISOLA",
"district_code": "32.73.01",
"district_name": "SUKASARI",
"regency_code": "32.73",
"regency_name": "KOTA BANDUNG",
"province_code": "32",
"province_name": "JAWA BARAT",
"postal_code": "40154",
"kode_pos": "40154",
"bps_village_code": "3273010001",
"kemendagri_village_code": "32.73.01.1001",
"source_version": "2026.06",
"crosswalk_source_version": "BPS Semester 1 2025 / Kemendagri 2025",
"is_active": 1
}
],
"meta": {
"total": 151,
"page": 1,
"per_page": 20,
"total_pages": 8
}
}Dekode string QRIS EMVCo untuk menampilkan merchant name, nominal, dan currency di aplikasi kasir atau payment switcher.
Cara mencari kode pos Indonesia berdasarkan nama kelurahan, kecamatan, atau kabupaten/kota lewat REST API — cocok untuk form checkout dan aplikasi pengiriman.
Start free. Upgrade to Pro or Business, or buy pay as you go credits when you need a one-time top-up. Payments are processed through Sumopod.
Yearly saves 2 months
Do you want to skip subscriptions? Top up credits once from the dashboard and use them until they run out.
Open dashboardFor trying the API and early integration.
For projects that are starting to get real usage.
For production apps with higher traffic.
For high volume, SLA, or company contracts.
Quick answers to common questions about getting started, the free tier, API key security, data sources, and Sumopod billing.
