# Overview and quickstart

> Documentation index for AI agents: [/llms.txt](https://docs.apiindonesia.id/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](https://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:

```bash
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](https://docs.apiindonesia.id/errors.md).

## 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](https://apiindonesia.id/openapi.json) (also at [docs.apiindonesia.id/openapi.json](https://docs.apiindonesia.id/openapi.json)).
- MCP server for AI agents: `https://mcp.apiindonesia.id/mcp`. See [MCP server and agents](https://docs.apiindonesia.id/mcp.md).

## Next steps

- [Authentication](https://docs.apiindonesia.id/authentication.md)
- [Pricing and credits](https://docs.apiindonesia.id/pricing.md)
- [Errors and response envelope](https://docs.apiindonesia.id/errors.md)
- [Endpoint index](https://docs.apiindonesia.id/endpoints.md): every endpoint on one short page.
- Product guides: [Regions, postal codes and boundaries](https://docs.apiindonesia.id/products/wilayah-kodepos.md), [Public holidays and Hijri calendar](https://docs.apiindonesia.id/products/libur-hijriah.md), [Prayer times](https://docs.apiindonesia.id/products/sholat.md), [BMKG: earthquakes, weather, warnings and air quality](https://docs.apiindonesia.id/products/bmkg.md), [Schools, universities and hospitals](https://docs.apiindonesia.id/products/pendidikan-kesehatan.md), [Finance: exchange rates, minimum wage, QRIS and rupiah](https://docs.apiindonesia.id/products/keuangan.md), [Validation and test data](https://docs.apiindonesia.id/products/validasi.md), [Halal, BPOM, trademarks and OJK](https://docs.apiindonesia.id/products/regulasi.md), [Other data: Al-Quran, Alkitab, KBBI, plates, astronomy, food prices](https://docs.apiindonesia.id/products/referensi.md), [Other data: Transjakarta and points of interest](https://docs.apiindonesia.id/products/transport-poi.md), [Toll roads: toll gates, roads and tariffs](https://docs.apiindonesia.id/products/jalan-tol.md), [Airports and ports](https://docs.apiindonesia.id/products/bandara-pelabuhan.md), [Bus terminals and railway stations](https://docs.apiindonesia.id/products/terminal-stasiun.md), [Wages, customs and energy regulation](https://docs.apiindonesia.id/products/regulasi-ekonomi.md), [Public facilities](https://docs.apiindonesia.id/products/fasilitas-publik.md), [Other data: world geo, IP geolocation and LEI](https://docs.apiindonesia.id/products/geo-ip-lei.md), [Image upscale](https://docs.apiindonesia.id/products/image-upscale.md).