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.

[ biznes · podmiot ]● 3 kred. · 30 zapytań/min

Wyszukiwanie podmiotu po LEI

Zidentyfikuj podmiot prawny w rejestrze GLEIF według kodu LEI lub nazwy. Oficjalna nazwa, adresy, jurysdykcja, krajowy numer rejestrowy, kody BIC oraz powiązania ze spółką dominującą i zależnymi.

Oficjalnie od GLEIFISO 17442CC0, domena publiczna

auth · x-api-key

Klucz API

Nie masz klucza API?

Zaloguj się na swoje konto, aby tworzyć klucze API i nimi zarządzać.

Zaloguj się Zarządzaj kluczami API

[ 02 · integrate ]

Przewodnik integracji

Skopiuj fragment kodu, podmień swój klucz API, uruchom. Działa w dowolnym kliencie HTTP — przykłady poniżej w cURL, JavaScript i Pythonie.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parametry

leistringopcjonalne

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

namestringopcjonalne

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

countrystringopcjonalne

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

include_relationshipsbooleanopcjonalne

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 · odpowiedź

{
  "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
}

Stworzone do rzeczywistych przypadków użycia

🔗

Identyfikacja podmiotów

Zamień niespójną nazwę firmy w CRM na jeden kanoniczny identyfikator, który czysto łączy dane między systemami i jurysdykcjami.

🏛️

KYC kontrahentów

Potwierdź zarejestrowaną nazwę, jurysdykcję i krajowy numer rejestrowy kontrahenta w oficjalnym źródle.

🌳

Mapowanie struktury właścicielskiej

Prześledź powiązania spółek dominujących i zależnych, aby przed udzieleniem kredytu lub podpisaniem umowy ustalić, kto ostatecznie kontroluje podmiot.

🤖

Agenci badawczy

Daj agentowi badawczemu źródło tożsamości, na które można się powołać, aby twierdzenia o podmiotach opierały się na rejestrze, a nie na domysłach.

Pola odpowiedzi

Pole	Typ	Opis
mode	string	Rodzaj wykonanego zapytania: lei albo search
record.lei	string	20-znakowy identyfikator zgodny z ISO 17442
record.legal_name	string \| null	Oficjalna zarejestrowana nazwa
record.other_names	string[]	Wcześniejsze i alternatywne nazwy figurujące w rejestrze
record.legal_address	object \| null	Adres siedziby w podziale na wiersze, miasto, region, kraj i kod pocztowy
record.jurisdiction	string \| null	Jurysdykcja utworzenia, np. US-CA
record.registered_as	string \| null	Numer w krajowym rejestrze przedsiębiorców — pomost do lokalnych dokumentów
record.entity_status	string \| null	ACTIVE albo INACTIVE
record.bic	string[]	Powiązane kody SWIFT/BIC, o ile podmiot je posiada
record.registration_status	string \| null	Status cyklu życia LEI, np. ISSUED albo LAPSED
relationships	object	Obecne przy include_relationships: bezpośrednia i ostateczna spółka dominująca oraz liczba spółek zależnych
total_matches	integer	Tylko w trybie wyszukiwania: ile rekordów pasuje do nazwy
credits_used	integer	Kredyty odjęte za to żądanie
remaining_credits	integer	Kredyty pozostałe na Twoim koncie

[ 03 · limits ]

Limity zapytań

Ograniczanie działa per klucz API, w przesuwnym oknie 60 sekund. Po przekroczeniu limitu otrzymasz czyste 429 z nagłówkiem Retry-After.

częstotliwość żądań

30req/min

Per klucz API, per endpoint. Przesuwne okno 60 sekund.

współbieżność

3concurrent

Maksymalna liczba jednoczesnych żądań w toku na klucz API.

nagłówki odpowiedzi

X-RateLimit-LimitMaksymalna dozwolona liczba żądań na minutę

X-RateLimit-RemainingPozostała liczba żądań w bieżącym oknie

X-RateLimit-ResetSekundy do zresetowania bieżącego okna

Retry-AfterSekundy oczekiwania przed ponowieniem (tylko przy 429)

● 429 · zbyt wiele żądań

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
}

Źródło danych i licencja

Rekordy pochodzą z GLEIF, Global Legal Entity Identifier Foundation, która prowadzi rejestr LEI w imieniu Regulatory Oversight Committee. GLEIF publikuje zarówno dane referencyjne poziomu 1, jak i dane właścicielskie poziomu 2 na licencji CC0 — domena publiczna, bez wymogu podawania źródła i bez ograniczeń dalszego wykorzystania.

Najczęściej zadawane pytania

P: Czym jest LEI i dlaczego warto używać go jako klucza?

O: Legal Entity Identifier to 20-znakowy kod zgodny z ISO 17442, który jednoznacznie identyfikuje jeden podmiot prawny na całym świecie — wymagany od każdego, kto działa na regulowanych rynkach finansowych. W przeciwieństwie do nazwy firmy nie budzi wątpliwości, a w przeciwieństwie do krajowego numeru rejestrowego nie powtarza się między jurysdykcjami, dlatego jest właściwym kluczem łączącym dane.

P: Czy mogę szukać, nie znając LEI?

O: Tak. Zamiast lei podaj name, aby przeszukać rejestr po nazwie, opcjonalnie zawężając wynik przez country. Filtr nazwy w GLEIF to dopasowanie według trafności, a nie dokładne, więc total_matches bywa duże — zwracane rekordy to czołówka tej listy.

P: Jak uzyskać strukturę grupy kapitałowej?

O: Dodaj include_relationships=true do zapytania po LEI. Otrzymasz bezpośrednią spółkę dominującą, ostateczną spółkę dominującą oraz liczbę bezpośrednich spółek zależnych, przy czym każda spółka dominująca jest oznaczona własnym LEI, więc kolejnymi wywołaniami możesz przechodzić drzewo w górę lub w dół.

P: Jak aktualne są dane?

O: GLEIF codziennie publikuje nową wzorcową kopię rejestru, a ten endpoint odpytuje ich API na żywo, a nie lokalną migawkę. Podmioty muszą co roku odnawiać LEI, więc registration_status i next_renewal_date mówią, czy rekord jest aktywnie utrzymywany, czy wygasł.

P: Czy dane można swobodnie rozpowszechniać?

O: GLEIF publikuje dane referencyjne LEI na licencji CC0, w domenie publicznej, bez jakichkolwiek ograniczeń licencyjnych dotyczących dalszego wykorzystania. W przypadku danych o podmiotach to rzadkość i właśnie dlatego ten endpoint istnieje — to samo zapytanie u komercyjnego dostawcy zwykle wiąże się z warunkami rozpowszechniania.