API Reference

Regions

The Indonesia Regions API covers 38 provinces, 514 regencies/cities, 7,285 districts and 83,762 villages, keyed by Kemendagri region codes. Each level has list and detail endpoints plus a cross-level name search, so you can build cascading address dropdowns without maintaining your own dataset.

Data as of · Source: Kepmendagri 2025 (cahyadsn/wilayah transcription)

Main endpoint
GET https://use.apiindonesia.id/api/v1/wilayah/provinsi
Endpoints
12
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Indonesian administrative region data from province down to village level, complete with region codes, postal codes, and coordinates. All list endpoints support pagination.

Coverage
12

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/wilayah/provinsi

Returns a list of all provinces in Indonesia.

When should you use it?

The Regions API fits apps that need a clean Indonesian address structure: provinces, regencies/cities, districts, down to villages. It works well for checkout, onboarding, branch search, service areas, and region analysis without shipping static address lists in the frontend.

You need cascading address dropdowns that stay consistent across web, mobile, and admin panels.

You need region codes to connect user records with internal reporting.

You need basic coordinates for location search or service-area estimates.

For legal address validation, pair this API with your own business rules. Region data gives structure, not proof of someone’s domicile.

Example product scenarios

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.

  • E-commerce & logistics: build cascading address dropdowns (province → village) for checkout or shipping forms.
  • Fintech & KYC: validate a customer's domicile against official Kemendagri region codes.
  • Research & government tooling: run region-based analysis without maintaining your own administrative dataset.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/wilayah/provinsi?page=1&per_page=20" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": [
    {
      "id": "32",
      "code": "32",
      "name": "JAWA BARAT",
      "alt_name": "Jawa Barat",
      "lat": -6.914744,
      "lng": 107.609811,
      "is_active": 1
    }
  ],
  "meta": {
    "total": 38,
    "page": 1,
    "per_page": 20,
    "total_pages": 2
  }
}

Browse the data

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Regions API questions

How many regions does the Regions API cover?

It covers 38 provinces, 514 regencies/cities, 7,285 districts and 83,762 villages, keyed by Kemendagri region codes.

How do I build a cascading address dropdown?

Load provinces from GET /api/v1/wilayah/provinsi, then each child level with /provinsi/{id}/kabupaten, /kabupaten/{id}/kecamatan and /kecamatan/{id}/kelurahan. Village records already include the postal code.

Can I search regions by name?

Yes. GET /api/v1/wilayah/search?q=... searches names across all levels at once (minimum 2 characters), and the level field tells you whether each result is a province, regency/city, district or village.

Is there sample data I can download without an API key?

Yes. The 38 provinces and 514 regencies/cities are free JSON files at apiindonesia.id/data/provinsi.json and apiindonesia.id/data/kabupaten-kota.json. Districts and villages are available through the API.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization