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.

[ zakelijk · rechtspersoon ]● 3 cred. · 30 verz./min

LEI- entiteitsopvraging API

Identificeer een rechtspersoon in het GLEIF-register op LEI-code of op naam. Officiële statutaire naam, adressen, jurisdictie, nationaal handelsregisternummer, BIC-codes en moeder-dochterrelaties.

Officieel van GLEIFISO 17442CC0, publiek domein

auth · x-api-key

API key

Heb je geen API key?

Meld je aan bij je account om je API keys aan te maken en te beheren.

Aanmelden API keys beheren

[ 02 · integrate ]

Integratiegids

Kopieer een snippet, vervang je API key, draaien. Werkt in elke HTTP-client — voorbeelden hieronder in cURL, JavaScript en Python.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parameters

leistringoptioneel

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

namestringoptioneel

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

countrystringoptioneel

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

include_relationshipsbooleanoptioneel

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 · reactie

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

Gebouwd voor praktijksituaties

🔗

Entiteitsidentificatie

Maak van een rommelige bedrijfsnaam in een CRM één canonieke identificatie die schoon koppelt tussen systemen en jurisdicties.

🏛️

KYC op tegenpartijen

Bevestig de geregistreerde statutaire naam, jurisdictie en het nationale registernummer van een tegenpartij aan de hand van een officiële bron.

🌳

Eigendomsstructuur in kaart brengen

Volg de moeder- en dochterrelaties om te zien wie een rechtspersoon uiteindelijk beheerst, vóórdat je krediet verstrekt of tekent.

🤖

Onderzoeksagents

Geef een onderzoeksagent een citeerbare identiteitsbron, zodat uitspraken over rechtspersonen terug te voeren zijn op een register in plaats van op een gok.

Responsvelden

Veld	Type	Beschrijving
mode	string	Welke opvraging is uitgevoerd: lei of search
record.lei	string	De identificatie van 20 tekens volgens ISO 17442
record.legal_name	string \| null	Officieel geregistreerde statutaire naam
record.other_names	string[]	Eerdere en alternatieve namen zoals vastgelegd
record.legal_address	object \| null	Statutair adres, opgesplitst in regels, plaats, regio, land en postcode
record.jurisdiction	string \| null	Jurisdictie van oprichting, bijv. US-CA
record.registered_as	string \| null	Nummer in het nationale handelsregister — de brug naar lokale deponeringen
record.entity_status	string \| null	ACTIVE of INACTIVE
record.bic	string[]	Gekoppelde SWIFT-/BIC-codes, als de rechtspersoon die heeft
record.registration_status	string \| null	Status in de levenscyclus van de LEI, bijv. ISSUED of LAPSED
relationships	object	Aanwezig bij include_relationships: directe moeder, uiteindelijke moeder en aantal dochters
total_matches	integer	Alleen in zoekmodus: hoeveel records op de naam matchen
credits_used	integer	Voor dit verzoek afgeschreven credits
remaining_credits	integer	Resterende credits in je account

[ 03 · limits ]

Rate limits

Throttling is per API key, een verschuivend venster van 60 seconden. Bereik je de limiet, dan krijg je een nette 429 met een Retry-After-header.

verzoeksnelheid

30req/min

Per API key, per endpoint. Verschuivend venster van 60 seconden.

gelijktijdigheid

3concurrent

Max. gelijktijdig lopende verzoeken per API key.

response headers

X-RateLimit-LimitMaximaal toegestane verzoeken per minuut

X-RateLimit-RemainingResterende verzoeken in het huidige venster

X-RateLimit-ResetSeconden tot het huidige venster opnieuw start

Retry-AfterSeconden te wachten voor opnieuw proberen (alleen bij 429)

● 429 · te veel verzoeken

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
}

Gegevensbron en licentie

De records komen van GLEIF, de Global Legal Entity Identifier Foundation, die het LEI-register beheert namens het Regulatory Oversight Committee. GLEIF publiceert zowel de referentiegegevens van niveau 1 als de eigendomsgegevens van niveau 2 onder CC0 — publiek domein, zonder naamsvermeldingsplicht en zonder beperking op verder gebruik.

Veelgestelde vragen

V: Wat is een LEI en waarom is het een goede sleutel?

A: Een Legal Entity Identifier is een code van 20 tekens volgens ISO 17442 die wereldwijd één rechtspersoon identificeert — verplicht voor iedereen die handelt op gereguleerde financiële markten. Anders dan een bedrijfsnaam is hij ondubbelzinnig, en anders dan een nationaal registernummer botst hij niet tussen jurisdicties, waardoor hij de juiste koppelsleutel is.

V: Kan ik zoeken zonder de LEI te kennen?

A: Ja. Geef name mee in plaats van lei om het register op statutaire naam te doorzoeken, eventueel beperkt met country. Het naamfilter van GLEIF is een relevantiematch en geen exacte match, dus total_matches kan hoog uitvallen — de teruggegeven records vormen de kop van die ranglijst.

V: Hoe krijg ik de concernstructuur?

A: Voeg include_relationships=true toe aan een opvraging op LEI. Je krijgt de directe moedermaatschappij, de uiteindelijke moedermaatschappij en het aantal directe dochters, elk met de eigen LEI, zodat je de boom met vervolgaanroepen omhoog of omlaag kunt doorlopen.

V: Hoe actueel zijn de gegevens?

A: GLEIF publiceert dagelijks een nieuwe golden copy van het register, en deze endpoint bevraagt hun live API in plaats van een lokale momentopname. Rechtspersonen moeten hun LEI jaarlijks verlengen, dus registration_status en next_renewal_date laten zien of een record actief wordt bijgehouden of is verlopen.

V: Mogen de gegevens vrij worden verspreid?

A: GLEIF publiceert de LEI-referentiegegevens onder CC0 in het publieke domein, zonder enige licentiebeperking op verder gebruik. Dat is ongebruikelijk voor gegevens over rechtspersonen en precies de reden dat deze endpoint bestaat — dezelfde opvraging bij een commerciële aanbieder komt doorgaans met voorwaarden voor herverspreiding.