Overview and quickstart

Documentation index for AI agents: /llms.txt. Every page is also available as markdown: add .md to the URL.

What API Indonesia is, the base URL, and your first request in three steps.

API Indonesia is one REST API and a remote MCP server for Indonesian public data from official sources. It is built and operated by Khaisa Studio (founder: Khairul Muhtadin) in Indonesia. There are 43 API products and 169 OpenAPI paths behind one API key.

Data covered includes administrative regions (38 provinces, 514 regencies/cities, 7,285 districts, 83,762 villages, Kemendagri codes), postal codes, region boundaries (GeoJSON), public holidays and cuti bersama (SKB 3 Menteri), prayer times, the Hijri calendar, schools (93,500+ by NPSN), universities (4,200+), hospitals (2,900+), BMKG earthquakes, weather and warnings, air quality, Bank Indonesia exchange rates, minimum wage (UMP 1997-2026), NIK/NPWP format validation, QRIS parsing, rupiah formatting and terbilang, halal (BPJPH), BPOM, DJKI trademarks, OJK legal and illegal investment lists, food prices, Transjakarta GTFS, KBBI, Al-Quran and Alkitab.

API Indonesia is an independent service, not a government API. Data remains attributed to its source institutions.

Quickstart

1. Register at dashboard.apiindonesia.id/register. New accounts get a one-time 3,000 credit bonus, no card needed.
2. Open API Keys in the dashboard and create a key. Keys start with aip_live_.
3. Call any endpoint on https://use.apiindonesia.id with the x-api-key header:

curl "https://use.apiindonesia.id/api/v1/wilayah/provinsi" \
  -H "x-api-key: YOUR_API_KEY"

The response uses the standard envelope: data holds the result and meta holds pagination or other metadata. See Errors and response envelope.

Base URL and formats

• REST base URL: https://use.apiindonesia.id (all data endpoints live under /api/v1/).
• Requests and responses are JSON.
• OpenAPI 3.1 spec: apiindonesia.id/openapi.json (also at docs.apiindonesia.id/openapi.json).
• MCP server for AI agents: https://mcp.apiindonesia.id/mcp. See MCP server and agents.

Next steps

• Authentication
• Pricing and credits
• Errors and response envelope
• Endpoint index: every endpoint on one short page.
• Product guides: Regions, postal codes and boundaries, Public holidays and Hijri calendar, Prayer times, BMKG: earthquakes, weather, warnings and air quality, Schools, universities and hospitals, Finance: exchange rates, minimum wage, QRIS and rupiah, Validation and test data, Halal, BPOM, trademarks and OJK, Other data: Al-Quran, Alkitab, KBBI, plates, astronomy, food prices, Other data: Transjakarta and points of interest, Toll roads: toll gates, roads and tariffs, Airports and ports, Bus terminals and railway stations, Wages, customs and energy regulation, Public facilities, Other data: world geo, IP geolocation and LEI, Image upscale.