# lokalapi

> Pay-per-request Indonesian reference data for AI agents. Payment via x402 (HTTP 402, USDC on Base). No API key, no account.

## How to pay
Call any /v1 endpoint. Without payment you get HTTP 402 with a PAYMENT-REQUIRED header (x402 v2). Sign the USDC authorization with an x402 client (e.g. @x402/fetch, @x402/mcp, AWS AgentCore payments) and retry.

## Endpoints
- GET /v1/wilayah/search?q={name}&level={provinsi|kabupaten_kota|kecamatan|desa_kelurahan}&parent={code}&limit={1-25} — $0.005. Official Indonesian administrative regions (Kepmendagri No. 300.2.2-2430/2025) with codes and full hierarchy.
- GET /v1/wilayah/{kode} — $0.002. Resolve a region code (e.g. 34.71) to name, type and hierarchy.
- GET /v1/kbli/search?q={business activity, Indonesian or English}&level={kelompok|subgolongan|golongan} — $0.02. KBLI 2025 business classification lookup (mandatory in OSS since 15 June 2026).
- GET /v1/kbli/convert?code={KBLI 2020 code} — $0.02. Official BPS KBLI 2020 -> 2025 conversion.

## Sources
- Region codes: Kepmendagri No. 300.2.2-2430 Tahun 2025, compiled by github.com/cahyadsn/wilayah (MIT).
- KBLI: Badan Pusat Statistik (BPS-Statistics Indonesia), bps.go.id. Reused under BPS Terms of Use with attribution.

## Operator
- Website: https://lokalapi.com
- Terms of Service: https://lokalapi.com/terms
- Contact: https://lokalapi.com/kontakt (kontakt@lokalapi.com)
- Legal notice (Impressum): https://lokalapi.com/impressum

Not legal advice.