# API Indonesia

> API Indonesia is one REST API and remote MCP server for Indonesian public data from official sources: regions and postal codes, holidays, prayer times, BMKG, schools, hospitals, exchange rates, minimum wage, validation, halal, BPOM, trademarks, OJK and more. One `x-api-key` header, one JSON envelope.

This file indexes the docs at https://docs.apiindonesia.id. Every page below links to its markdown version; the HTML version is the same URL without `.md`, and pages also return markdown for `Accept: text/markdown`. Setup instructions for AI agents and the product overview are in https://apiindonesia.id/llms.txt .

## Guides

- [Overview and quickstart](https://docs.apiindonesia.id/overview.md): What API Indonesia is, the base URL, and your first request in three steps.
- [Authentication](https://docs.apiindonesia.id/authentication.md): API keys, the x-api-key header, MCP bearer auth and keeping keys secret.
- [Pricing and credits](https://docs.apiindonesia.id/pricing.md): Signup bonus, credits per request, plans, rate limits and top-ups (in rupiah).
- [Errors and response envelope](https://docs.apiindonesia.id/errors.md): The JSON envelope for success and error responses, status codes and retries.
- [MCP server and AI agents](https://docs.apiindonesia.id/mcp.md): Connect Claude Code, Cursor, Codex and other MCP clients to the remote MCP server.

## Products

- [Regions, postal codes and boundaries](https://docs.apiindonesia.id/products/wilayah-kodepos.md): Kemendagri administrative regions from province to village, postal codes and GeoJSON boundaries.
- [Public holidays and Hijri calendar](https://docs.apiindonesia.id/products/libur-hijriah.md): National holidays and cuti bersama (SKB 3 Menteri), plus Hijri date conversion and calendar.
- [Prayer times](https://docs.apiindonesia.id/products/sholat.md): Daily and monthly prayer times for Indonesian regencies and cities.
- [BMKG: earthquakes, weather, warnings and air quality](https://docs.apiindonesia.id/products/bmkg.md): BMKG earthquakes, 3-day weather forecasts, early weather warnings and air quality.
- [Schools, universities and hospitals](https://docs.apiindonesia.id/products/pendidikan-kesehatan.md): Schools by NPSN, universities and hospitals.
- [Finance: exchange rates, minimum wage, QRIS and rupiah](https://docs.apiindonesia.id/products/keuangan.md): Bank Indonesia and ECB exchange rates, UMP 1997-2026, QRIS parsing and rupiah formatting/terbilang.
- [Validation and test data](https://docs.apiindonesia.id/products/validasi.md): NIK, NPWP and bank account format validation, plus dummy NIK/NPWP/phone generators for testing.
- [Halal, BPOM, trademarks and OJK](https://docs.apiindonesia.id/products/regulasi.md): BPJPH halal certificates, BPOM products, DJKI trademarks and OJK legal/illegal investment lists.
- [Other data: Al-Quran, Alkitab, KBBI, plates, astronomy, food prices](https://docs.apiindonesia.id/products/referensi.md): Al-Quran, Alkitab, KBBI dictionary, vehicle plate codes, astronomy, food prices and dataset metadata.
- [Other data: Transjakarta and points of interest](https://docs.apiindonesia.id/products/transport-poi.md): Transjakarta GTFS routes, stops, fares and schedules, plus points of interest in Indonesia.
- [Toll roads: toll gates, roads and tariffs](https://docs.apiindonesia.id/products/jalan-tol.md): Indonesian toll gates with coordinates, the BPJT toll road list and BPJT tariffs, plus nearest-gate search.
- [Airports and ports](https://docs.apiindonesia.id/products/bandara-pelabuhan.md): Indonesian airports with coordinates and ICAO/IATA codes, and sea and ferry ports from the National Port Master Plan, plus nearest search.
- [Bus terminals and railway stations](https://docs.apiindonesia.id/products/terminal-stasiun.md): Indonesian bus terminals (type A per PM 1/2025 plus open-source terminals) and railway stations with codes, plus nearest search.
- [Wages, customs and energy regulation](https://docs.apiindonesia.id/products/regulasi-ekonomi.md): Regency minimum wages (UMK), HS import duty rates, and PLN electricity tariffs or subsidised fuel prices, each row citing its regulation.
- [Public facilities](https://docs.apiindonesia.id/products/fasilitas-publik.md): Puskesmas, fuel stations, police offices, fire stations, post offices and places of worship, with coordinates and nearest search.
- [Other data: world geo, IP geolocation and LEI](https://docs.apiindonesia.id/products/geo-ip-lei.md): Countries, cities and time zones, IP geolocation and legal entity identifiers (LEI).
- [Image upscale](https://docs.apiindonesia.id/products/image-upscale.md): Enlarge an image 2x, 4x or 8x as an async job, then download the result.

## Reference

- [Endpoint index](https://docs.apiindonesia.id/endpoints.md): Every API Indonesia endpoint (170 operations) on one short page.
- [OpenAPI 3.1 spec](https://apiindonesia.id/openapi.json): machine-readable description of every endpoint.
- [Full docs in one file](https://docs.apiindonesia.id/llms-full.txt): all pages above concatenated as markdown.

## Optional

- [API Indonesia llms.txt](https://apiindonesia.id/llms.txt): product overview, pricing and agent setup instructions.
- [Status page](https://status.apiindonesia.id/)