lokalapi – Indonesian reference data

Free. Explains the paid tools, prices and how an agent pays per call via x402 (USDC on Base). Call this first.

{
  "type": "object",
  "properties": {}
}

Search official Indonesian administrative regions (province, regency/city, district, village) by name and get the official Kemendagri 2025 code plus full hierarchy. Handles 'Kab.', 'Kota', 'Kec.' prefixes. Costs $0.005 per call (x402, USDC on Base; see lokalapi_info).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "description": "Region name, e.g. 'Sleman', 'Kota Yogyakarta', 'Sinduharjo'"
    },
    "level": {
      "type": "string",
      "enum": [
        "provinsi",
        "kabupaten_kota",
        "kecamatan",
        "desa_kelurahan"
      ]
    },
    "parent": {
      "type": "string",
      "description": "Restrict to children of this code, e.g. '34.04'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results (1-25, default 10)"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resolve an official Indonesian region code (Kemendagri 2025, e.g. '34.71' or '34.04.12.2001') to its name, type and full administrative hierarchy. Costs $0.002 per call (x402, USDC on Base; see lokalapi_info).

{
  "type": "object",
  "properties": {
    "kode": {
      "type": "string",
      "minLength": 2,
      "description": "Region code, e.g. '34.71'"
    }
  },
  "required": [
    "kode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find the right KBLI 2025 business classification code (5-digit, mandatory in Indonesia's OSS business licensing since 15 June 2026) from a free-text business activity in Indonesian or English. Returns official BPS titles, descriptions and hierarchy. Costs $0.02 per call (x402, USDC on Base; see lokalapi_info).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "description": "Business activity, e.g. 'kafe', 'software development', 'nickel mining', or a KBLI code"
    },
    "level": {
      "type": "string",
      "enum": [
        "kelompok",
        "subgolongan",
        "golongan",
        "golongan_pokok",
        "kategori"
      ],
      "description": "Classification level (default kelompok = 5-digit code)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results (1-25, default 10)"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Convert a KBLI 2020 business code to its KBLI 2025 equivalent(s) using the official BPS conversion table (2026). Flags one-to-many splits. Needed to update OSS/NIB licences after the June 2026 switch. Costs $0.02 per call (x402, USDC on Base; see lokalapi_info).

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "5-digit KBLI 2020 code, e.g. '63122'"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Convert up to 50 KBLI 2020 business codes to KBLI 2025 in one call (official BPS conversion table, 2026), e.g. all codes of a company's OSS/NIB licence. Per code: status one_to_one, split, merged, not_found or invalid, the KBLI 2025 candidates, and needs_review with the reason; plus a summary. format=csv returns a spreadsheet. Charged only if at least one code converts. Costs $0.50 per call (x402, USDC on Base; see lokalapi_info).

{
  "type": "object",
  "properties": {
    "codes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 32
      },
      "minItems": 1,
      "maxItems": 100,
      "description": "KBLI 2020 codes (5 digits), at most 50 unique, e.g. ['62019', '46900']"
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "csv"
      ],
      "description": "csv: one line per old -> new code pair (default json)"
    }
  },
  "required": [
    "codes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}