API Reference

Indonesian Legal Entity Identifiers (GLEIF Golden Copy)

Compliance & KYB category: Legal Entity Identifiers (LEI, ISO 17442) for legal entities whose legal or headquarters address is in Indonesia, with legal and other names, entity and LEI registration status, legal form (ELF code), legal and headquarters addresses, registration-authority number, registration and next-renewal dates, the managing LOU, and the direct and ultimate parent, including parents abroad. The data comes from the GLEIF Golden Copy files, licensed CC0.

Main endpoint
GET https://use.apiindonesia.id/api/v1/lei
Endpoints
3
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Data source
Data source: the GLEIF Golden Copy (LEI-CDF and RR-CDF files, CSV format) from https://goldencopy.gleif.org, released under CC0 1.0 per the terms of use at https://www.gleif.org/en/meta/lei-data-terms-of-use. API Indonesia is not affiliated with GLEIF and this service is not endorsed by GLEIF. What API Indonesia changed: the data is filtered to entities with an Indonesian legal or headquarters address plus their direct/ultimate parents and their foreign subsidiaries, then normalised to JSON. Every successful response carries meta.attribution with the source, the licence and file_date (the publish time of the golden copy used). Parent reporting exceptions and ELF code names are not included in this version.
Product Brief

What this API gives you

Compliance & KYB category: Legal Entity Identifiers (LEI, ISO 17442) for legal entities whose legal or headquarters address is in Indonesia, with legal and other names, entity and LEI registration status, legal form (ELF code), legal and headquarters addresses, registration-authority number, registration and next-renewal dates, the managing LOU, and the direct and ultimate parent, including parents abroad. The data comes from the GLEIF Golden Copy files, licensed CC0.

Data source: the GLEIF Golden Copy (LEI-CDF and RR-CDF files, CSV format) from https://goldencopy.gleif.org, released under CC0 1.0 per the terms of use at https://www.gleif.org/en/meta/lei-data-terms-of-use. API Indonesia is not affiliated with GLEIF and this service is not endorsed by GLEIF. What API Indonesia changed: the data is filtered to entities with an Indonesian legal or headquarters address plus their direct/ultimate parents and their foreign subsidiaries, then normalised to JSON. Every successful response carries meta.attribution with the source, the licence and file_date (the publish time of the golden copy used). Parent reporting exceptions and ELF code names are not included in this version.

Coverage
3

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/lei

Searches the 1,644 entities with an Indonesian legal or headquarters address (golden copy snapshot of 1 November 2026). q matches the legal name and other/transliterated names through a full-text index (word prefixes). The provinsi filter applies to both the legal and headquarters address; some GLEIF records still use retired island codes (for example ID-JW for Java) and those are not rolled up into provinces.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • KYB & corporate onboarding: match a prospect or counterparty LEI against its legal name, address and registration status before transacting.
  • Financial reporting & treasury: fill LEI fields in transaction reports and check whether an LEI is still ISSUED or has LAPSED.
  • Corporate-group research: trace the direct and ultimate parent of Indonesian companies, including parents abroad.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/lei?q=pertamina&per_page=1" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "success": true,
  "data": [
    {
      "lei": "254900X2NUD6BMNZKP36",
      "legal_name": "PT Kilang Pertamina Balikpapan",
      "entity_status": "ACTIVE",
      "registration_status": "ISSUED",
      "legal_form_code": "UD1V",
      "legal_city": "SOUTH JAKARTA",
      "legal_region": "ID-JK",
      "legal_country": "ID",
      "hq_city": "SOUTH JAKARTA",
      "hq_region": "ID-JK",
      "next_renewal_date": "2027-04-30T09:36:04.136Z",
      "legal_region_name": "DKI Jakarta",
      "hq_region_name": "DKI Jakarta"
    }
  ],
  "meta": {
    "total": 6,
    "page": 1,
    "per_page": 1,
    "total_pages": 6,
    "attribution": {
      "source": "GLEIF Golden Copy (LEI-CDF dan RR-CDF)",
      "license": "CC0 1.0",
      "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
      "source_url": "https://goldencopy.gleif.org",
      "attribution_page": "https://www.gleif.org/en/meta/lei-data-terms-of-use",
      "notice": "Data diubah: difilter ke entitas beralamat di Indonesia beserta induknya dan dinormalisasi ke format JSON API Indonesia. API Indonesia tidak berafiliasi dengan GLEIF dan layanan ini tidak didukung atau disahkan oleh GLEIF. / Filtered to Indonesian entities and their parents and normalised to the API Indonesia JSON format. API Indonesia is not affiliated with or endorsed by GLEIF.",
      "file_date": "2026-11-01T00:00:00Z"
    }
  }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Just need the file? The same data is also sold as a one-time file, no API key and no per-request credits.

See all datasets and their licences

Indonesian Legal Entity Identifiers (GLEIF Golden Copy) API questions

Which entities are covered?

Every LEI whose legal or headquarters address is in Indonesia (1,644 in the 1 November 2026 snapshot), plus their direct/ultimate parents and foreign subsidiaries so relationships resolve.

Is the LEI validated?

Yes. The 20-character shape and the ISO 17442 (MOD 97-10) checksum are checked first; a malformed LEI answers 400 INVALID_LEI.

Is this an official GLEIF service?

No. The data comes from the CC0-licensed GLEIF Golden Copy, but API Indonesia is not affiliated with or endorsed by GLEIF. The file date used is in meta.attribution.file_date.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization