What is an LEI and why use it as a key?

A Legal Entity Identifier is a 20-character ISO 17442 code that identifies one legal entity worldwide — required for anyone trading in regulated financial markets. Unlike a company name it is unambiguous, and unlike a national register number it does not collide across jurisdictions, which makes it the right join key for entity resolution.

Can I search without knowing the LEI?

Yes. Pass name instead of lei to search the register by legal name, optionally narrowed with country. GLEIF's name filter is a relevance match rather than an exact one, so total_matches can be large — the returned records are the ranked head of that list.

How do I get the corporate ownership tree?

Add include_relationships=true to an LEI lookup. You get the direct parent, the ultimate parent, and a count of direct subsidiaries, each parent identified by its own LEI so you can walk the tree upward or downward with further calls.

How current is the data?

GLEIF publishes a new golden copy of the register daily, and this endpoint queries their live API rather than a local snapshot. Entities must renew their LEI annually, so registration_status and next_renewal_date tell you whether a record is actively maintained or has lapsed.

Is the data free to redistribute?

GLEIF publishes the LEI reference data under CC0, into the public domain, with no licensing restriction on downstream use. That is unusual for entity data and is why this endpoint exists — the same lookup from a commercial vendor typically comes with redistribution terms attached.

[ bisnis · entitas ]● 3 kredit · 30 permintaan/menit

Pencarian entitas LEI API

Identifikasi badan hukum di registri GLEIF berdasarkan kode LEI atau nama. Nama resmi, alamat, yurisdiksi, nomor registrasi perusahaan nasional, kode BIC, dan hubungan induk serta anak perusahaan.

Resmi dari GLEIFISO 17442CC0, domain publik

auth · x-api-key

API Key

Belum punya API key?

Masuk ke akun Anda untuk membuat dan mengelola API key.

Masuk Kelola API Key

[ 02 · integrate ]

Panduan integrasi

Salin snippet, ganti API key kamu, jalankan. Bekerja di HTTP client mana pun — contoh di bawah dalam cURL, JavaScript, dan Python.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parameter

leistringopsional

20-character LEI code. Mutually exclusive with name. HWUPKR0MPOU8FGXBT394

namestringopsional

Legal entity name to search for. Mutually exclusive with lei. Tesla, Inc.

countrystringopsional

ISO 3166-1 alpha-2 code narrowing a name search. US

include_relationshipsbooleanopsional

With lei, also return direct parent, ultimate parent, and subsidiary count. true

curl -X GET "https://www.apipick.com/api/lei-lookup" \
  -H "x-api-key: YOUR_API_KEY"

● 200 · respons

{
  "mode": "lei",
  "query": "HWUPKR0MPOU8FGXBT394",
  "found": true,
  "record": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legal_name": "Apple Inc.",
    "other_names": [
      "Apple Computer, Inc."
    ],
    "legal_address": {
      "lines": [
        "C/O C T Corporation System",
        "330 N. Brand Blvd"
      ],
      "city": "Glendale",
      "region": "US-CA",
      "country": "US",
      "postal_code": "91203"
    },
    "jurisdiction": "US-CA",
    "legal_form": "H1UM",
    "entity_status": "ACTIVE",
    "registered_as": "806592",
    "bic": [
      "APLEUS66XXX"
    ],
    "registration_status": "ISSUED",
    "next_renewal_date": "2027-03-08T17:27:20Z"
  },
  "relationships": {
    "direct_parent": null,
    "ultimate_parent": null,
    "direct_children_count": 8
  },
  "source": "GLEIF",
  "credits_used": 3,
  "remaining_credits": 97
}

Dibuat untuk Use Case Dunia Nyata

🔗

Resolusi entitas

Ubah nama perusahaan yang berantakan di CRM menjadi satu pengenal baku yang menyambung rapi antar sistem dan yurisdiksi.

🏛️

KYC mitra usaha

Pastikan nama badan hukum terdaftar, yurisdiksi, dan nomor registrasi nasional mitra usaha terhadap sumber resmi.

🌳

Pemetaan kepemilikan

Telusuri hubungan induk dan anak perusahaan untuk melihat siapa yang pada akhirnya mengendalikan sebuah entitas sebelum memberi kredit atau menandatangani perjanjian.

🤖

Agen riset

Beri agen riset sumber identitas yang bisa dirujuk, sehingga klaim tentang entitas dalam keluarannya bersandar pada registri, bukan pada tebakan.

Field respons

Field	Tipe	Deskripsi
mode	string	Jenis pencarian yang dijalankan: lei atau search
record.lei	string	Pengenal ISO 17442 sepanjang 20 karakter
record.legal_name	string \| null	Nama badan hukum resmi yang terdaftar
record.other_names	string[]	Nama terdahulu dan nama alternatif yang tercatat
record.legal_address	object \| null	Alamat terdaftar, dipecah menjadi baris, kota, wilayah, negara, dan kode pos
record.jurisdiction	string \| null	Yurisdiksi pendirian, mis. US-CA
record.registered_as	string \| null	Nomor pada registri perusahaan nasional — jembatan menuju dokumen setempat
record.entity_status	string \| null	ACTIVE atau INACTIVE
record.bic	string[]	Kode SWIFT/BIC yang terkait, bila entitas memilikinya
record.registration_status	string \| null	Status siklus hidup LEI, mis. ISSUED atau LAPSED
relationships	object	Muncul dengan include_relationships: induk langsung, induk tertinggi, dan jumlah anak perusahaan
total_matches	integer	Hanya pada mode pencarian: berapa banyak catatan yang cocok dengan nama tersebut
credits_used	integer	Kredit yang dipotong untuk request ini
remaining_credits	integer	Kredit yang tersisa di akun kamu

[ 03 · limits ]

Rate limit

Throttling berlaku per API key, jendela geser 60 detik. Jika melewati batas, kamu mendapat 429 yang rapi dengan header Retry-After.

laju request

30req/min

Per API key, per endpoint. Jendela geser 60 detik.

konkurensi

3concurrent

Maksimum request bersamaan yang sedang berjalan per API key.

header respons

X-RateLimit-LimitJumlah maksimum request yang diizinkan per menit

X-RateLimit-RemainingRequest yang tersisa di jendela saat ini

X-RateLimit-ResetDetik sampai jendela saat ini di-reset

Retry-AfterDetik yang harus ditunggu sebelum mencoba lagi (hanya pada 429)

● 429 · terlalu banyak request

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

Sumber data dan lisensi

Catatan berasal dari GLEIF, Global Legal Entity Identifier Foundation, yang mengelola registri LEI atas nama Regulatory Oversight Committee. GLEIF menerbitkan data referensi tingkat 1 maupun data kepemilikan tingkat 2 dengan lisensi CC0 — domain publik, tanpa kewajiban atribusi dan tanpa pembatasan penggunaan lanjutan.

Pertanyaan yang Sering Diajukan

T: Apa itu LEI dan mengapa dipakai sebagai kunci?

J: Legal Entity Identifier adalah kode ISO 17442 sepanjang 20 karakter yang mengidentifikasi satu badan hukum di seluruh dunia — wajib bagi siapa pun yang bertransaksi di pasar keuangan teregulasi. Tidak seperti nama perusahaan, kode ini tidak ambigu; tidak seperti nomor registrasi nasional, kode ini tidak bertabrakan antar yurisdiksi, sehingga menjadi kunci penghubung yang tepat.

T: Bisakah saya mencari tanpa tahu LEI-nya?

J: Bisa. Kirim name alih-alih lei untuk mencari registri berdasarkan nama badan hukum, dan persempit dengan country bila perlu. Filter nama GLEIF adalah pencocokan berdasarkan relevansi, bukan pencocokan persis, sehingga total_matches bisa besar — catatan yang dikembalikan adalah bagian teratas dari daftar itu.

T: Bagaimana cara memperoleh struktur grup perusahaan?

J: Tambahkan include_relationships=true pada pencarian berdasarkan LEI. Anda akan memperoleh induk langsung, induk tertinggi, dan jumlah anak perusahaan langsung, dengan tiap induk diidentifikasi oleh LEI-nya sendiri sehingga Anda bisa menelusuri pohonnya ke atas atau ke bawah lewat panggilan berikutnya.

T: Seberapa mutakhir datanya?

J: GLEIF menerbitkan salinan acuan registri yang baru setiap hari, dan endpoint ini menanyakan API langsung mereka, bukan snapshot lokal. Entitas wajib memperpanjang LEI setiap tahun, jadi registration_status dan next_renewal_date memberi tahu Anda apakah sebuah catatan masih aktif dipelihara atau sudah kedaluwarsa.

T: Apakah datanya bebas didistribusikan ulang?

J: GLEIF menerbitkan data referensi LEI dengan lisensi CC0 ke domain publik, tanpa pembatasan lisensi apa pun atas penggunaan lanjutan. Hal itu tidak lazim untuk data entitas dan justru itulah alasan endpoint ini ada — pencarian yang sama dari vendor komersial biasanya disertai syarat distribusi ulang.