[ Business · Rechtsträger ]● 3 Cr. · 30 Anfr./Min.

LEI- Rechtsträgersuche API

Löst einen Rechtsträger über das GLEIF-Register per LEI-Code oder Name auf. Offizielle Firmierung, Anschriften, Jurisdiktion, nationale Registernummer, BIC-Codes und Mutter-/Tochter-Verknüpfungen.

GLEIF offiziellISO 17442CC0, gemeinfrei
auth · x-api-key

Noch keinen API-Key?

Melde dich an, um API-Keys zu erstellen und zu verwalten.

[ 02 · integrate ]

Integrationsleitfaden

Snippet kopieren, deinen API-Key einsetzen, ausführen. Funktioniert in jedem HTTP-Client — Beispiele unten in cURL, JavaScript und Python.

spec
GET/api/lei-lookup
base
https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

Parameter
leistringoptional

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

namestringoptional

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

countrystringoptional

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

include_relationshipsbooleanoptional

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

Gebaut für reale Anwendungsfälle

🔗

Entitätsauflösung

Machen Sie aus einem uneinheitlichen Firmennamen im CRM eine kanonische Kennung, die sich system- und länderübergreifend sauber verknüpfen lässt.

🏛️

KYC für Geschäftspartner

Bestätigen Sie Firmierung, Jurisdiktion und nationale Registernummer eines Geschäftspartners anhand einer offiziellen Quelle.

🌳

Beteiligungsstruktur

Verfolgen Sie Mutter- und Tochterverknüpfungen, um vor Kreditvergabe oder Vertragsschluss zu sehen, wer einen Rechtsträger letztlich kontrolliert.

🤖

Recherche-Agenten

Geben Sie einem Recherche-Agenten eine zitierfähige Identitätsquelle, damit Aussagen über Rechtsträger auf ein Register zurückgehen und nicht auf eine Vermutung.

Antwortfelder

FeldTypBeschreibung
modestringWelche Abfrage ausgeführt wurde: lei oder search
record.leistringDie 20-stellige Kennung nach ISO 17442
record.legal_namestring | nullOffiziell eingetragene Firmierung
record.other_namesstring[]Frühere und alternative Namen laut Register
record.legal_addressobject | nullSitz laut Register, aufgeteilt in Zeilen, Ort, Region, Land und Postleitzahl
record.jurisdictionstring | nullJurisdiktion der Gründung, z. B. US-CA
record.registered_asstring | nullNummer im nationalen Handelsregister – die Brücke zu lokalen Offenlegungen
record.entity_statusstring | nullACTIVE oder INACTIVE
record.bicstring[]Zugeordnete SWIFT-/BIC-Codes, sofern vorhanden
record.registration_statusstring | nullStatus im LEI-Lebenszyklus, z. B. ISSUED oder LAPSED
relationshipsobjectVorhanden mit include_relationships: direkte Mutter, oberste Mutter und Anzahl der Töchter
total_matchesintegerNur im Suchmodus: wie viele Einträge zum Namen passen
credits_usedintegerFür diese Anfrage abgezogene Credits
remaining_creditsintegerVerbleibende Credits in deinem Account
[ 03 · limits ]

Rate-Limits

Die Drosselung erfolgt pro API-Key, gleitendes 60-Sekunden-Fenster. Beim Erreichen des Limits bekommst du ein sauberes 429 mit Retry-After-Header.

Anfragerate

30req/min

Pro API-Key, pro Endpunkt. Gleitendes 60-Sekunden-Fenster.

Nebenläufigkeit

3concurrent

Maximale gleichzeitige laufende Anfragen pro API-Key.

Antwort-Header
X-RateLimit-LimitMaximal zulässige Anfragen pro Minute
X-RateLimit-RemainingVerbleibende Anfragen im aktuellen Fenster
X-RateLimit-ResetSekunden bis zum Zurücksetzen des aktuellen Fensters
Retry-AfterSekunden Wartezeit vor erneutem Versuch (nur bei 429)
● 429 · zu viele Anfragen
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
}

Datenquelle & Lizenz

Die Einträge stammen von GLEIF, der Global Legal Entity Identifier Foundation, die das LEI-Register im Auftrag des Regulatory Oversight Committee führt. GLEIF veröffentlicht sowohl die Referenzdaten der Ebene 1 als auch die Beteiligungsdaten der Ebene 2 unter CC0 – gemeinfrei, ohne Namensnennungspflicht und ohne Einschränkung der Weiterverwendung.

Häufig gestellte Fragen

F: Was ist ein LEI und warum eignet er sich als Schlüssel?

A: Ein Legal Entity Identifier ist ein 20-stelliger Code nach ISO 17442, der weltweit genau einen Rechtsträger identifiziert – Pflicht für alle, die an regulierten Finanzmärkten handeln. Anders als ein Firmenname ist er eindeutig, und anders als eine nationale Registernummer kollidiert er nicht über Jurisdiktionen hinweg. Damit ist er der richtige Verknüpfungsschlüssel für die Entitätsauflösung.

F: Kann ich auch ohne den LEI suchen?

A: Ja. Übergeben Sie name statt lei, um das Register nach der Firmierung zu durchsuchen, optional eingegrenzt mit country. Der Namensfilter von GLEIF ist eine Relevanz- und keine exakte Übereinstimmung; total_matches kann daher groß sein – die zurückgegebenen Einträge sind der oberste Teil dieser Rangfolge.

F: Wie erhalte ich die Konzernstruktur?

A: Ergänzen Sie eine LEI-Abfrage um include_relationships=true. Sie erhalten die direkte Muttergesellschaft, die oberste Muttergesellschaft und die Anzahl direkter Tochtergesellschaften, jede Mutter mit eigenem LEI – so können Sie den Baum mit weiteren Aufrufen nach oben oder unten verfolgen.

F: Wie aktuell sind die Daten?

A: GLEIF veröffentlicht täglich eine neue Golden Copy des Registers, und dieser Endpunkt fragt deren Live-API ab, nicht einen lokalen Abzug. Rechtsträger müssen ihren LEI jährlich verlängern; registration_status und next_renewal_date zeigen Ihnen also, ob ein Eintrag aktiv gepflegt wird oder abgelaufen ist.

F: Dürfen die Daten frei weitergegeben werden?

A: GLEIF stellt die LEI-Referenzdaten unter CC0 gemeinfrei zur Verfügung, ohne jede Lizenzeinschränkung für die Weiterverwendung. Das ist bei Rechtsträgerdaten ungewöhnlich und genau der Grund für diesen Endpunkt – dieselbe Abfrage bei einem kommerziellen Anbieter ist in der Regel an Weitergabebedingungen geknüpft.