Recherche d'entité LEI API
Identifiez une entité juridique dans le registre GLEIF, par code LEI ou par nom. Dénomination sociale officielle, adresses, juridiction, numéro d'immatriculation national, codes BIC et liens mère-filiales.
Pas encore de clé API ?
Connectez-vous à votre compte pour créer et gérer vos clés API.
Guide d'intégration
Copiez un extrait, remplacez votre clé API, exécutez. Fonctionne avec n'importe quel client HTTP — exemples ci-dessous en cURL, JavaScript et Python.
/api/lei-lookuphttps://www.apipick.comResolve a legal entity through the GLEIF LEI register
leistringoptionnel20-character LEI code. Mutually exclusive with name. HWUPKR0MPOU8FGXBT394
namestringoptionnelLegal entity name to search for. Mutually exclusive with lei. Tesla, Inc.
countrystringoptionnelISO 3166-1 alpha-2 code narrowing a name search. US
include_relationshipsbooleanoptionnelWith 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"{
"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
}Conçu pour des cas d'usage réels
Résolution d'entités
Transformez un nom d'entreprise approximatif dans un CRM en un identifiant canonique qui se raccorde proprement entre systèmes et juridictions.
KYC de contreparties
Confirmez la dénomination sociale, la juridiction et le numéro d'immatriculation national d'une contrepartie auprès d'une source officielle.
Cartographie capitalistique
Remontez les liens mère-filiales pour savoir qui contrôle réellement une entité avant d'accorder un crédit ou de signer.
Agents de recherche
Offrez à un agent de recherche une source d'identité citable, pour que ses affirmations sur les entités renvoient à un registre plutôt qu'à une supposition.
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| mode | string | Type de recherche exécutée : lei ou search |
| record.lei | string | L'identifiant ISO 17442 de 20 caractères |
| record.legal_name | string | null | Dénomination sociale officielle enregistrée |
| record.other_names | string[] | Anciens noms et noms alternatifs figurant au registre |
| record.legal_address | object | null | Siège social, décomposé en lignes, ville, région, pays et code postal |
| record.jurisdiction | string | null | Juridiction de constitution, par ex. US-CA |
| record.registered_as | string | null | Numéro au registre national des sociétés — la passerelle vers les dépôts locaux |
| record.entity_status | string | null | ACTIVE ou INACTIVE |
| record.bic | string[] | Codes SWIFT/BIC associés, lorsque l'entité en possède |
| record.registration_status | string | null | Statut du cycle de vie du LEI, par ex. ISSUED ou LAPSED |
| relationships | object | Présent avec include_relationships : mère directe, mère ultime et nombre de filiales |
| total_matches | integer | Mode recherche uniquement : nombre d'enregistrements correspondant au nom |
| credits_used | integer | Crédits déduits pour cette requête |
| remaining_credits | integer | Crédits restants sur votre compte |
Limites de débit
La limitation est par clé API, fenêtre glissante de 60 secondes. En cas de dépassement, vous recevez un 429 propre avec un en-tête Retry-After.
30req/min
Par clé API, par endpoint. Fenêtre glissante de 60 secondes.
3concurrent
Nombre maximal de requêtes simultanées en cours par clé API.
X-RateLimit-LimitNombre maximal de requêtes autorisées par minuteX-RateLimit-RemainingRequêtes restantes dans la fenêtre actuelleX-RateLimit-ResetSecondes avant la réinitialisation de la fenêtre actuelleRetry-AfterSecondes à attendre avant de réessayer (uniquement sur 429)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
}Source des données et licence
Les enregistrements proviennent de GLEIF, la Global Legal Entity Identifier Foundation, qui tient le registre LEI pour le compte du Regulatory Oversight Committee. GLEIF publie les données de référence de niveau 1 comme les données capitalistiques de niveau 2 sous CC0 : domaine public, sans attribution obligatoire ni restriction d'usage en aval.
Questions fréquentes
Q : Qu'est-ce qu'un LEI et pourquoi l'utiliser comme clé ?
R : Un Legal Entity Identifier est un code ISO 17442 de 20 caractères qui identifie une entité juridique dans le monde entier — obligatoire pour quiconque intervient sur les marchés financiers régulés. Contrairement à un nom d'entreprise, il est non ambigu ; contrairement à un numéro d'immatriculation national, il n'entre pas en collision d'une juridiction à l'autre, ce qui en fait la bonne clé de rapprochement.
Q : Puis-je chercher sans connaître le LEI ?
R : Oui. Passez name plutôt que lei pour interroger le registre par dénomination sociale, éventuellement restreint par country. Le filtre par nom de GLEIF est une correspondance par pertinence et non une correspondance exacte : total_matches peut donc être élevé, les enregistrements renvoyés étant la tête de ce classement.
Q : Comment obtenir l'arbre capitalistique du groupe ?
R : Ajoutez include_relationships=true à une recherche par LEI. Vous obtenez la société mère directe, la société mère ultime et le nombre de filiales directes, chaque mère étant identifiée par son propre LEI, ce qui vous permet de remonter ou de descendre l'arbre avec d'autres appels.
Q : Les données sont-elles à jour ?
R : GLEIF publie chaque jour une nouvelle copie de référence du registre, et cet endpoint interroge leur API en direct, pas un instantané local. Les entités doivent renouveler leur LEI chaque année : registration_status et next_renewal_date vous indiquent donc si un enregistrement est activement tenu à jour ou s'il est périmé.
Q : Les données sont-elles librement redistribuables ?
R : GLEIF publie les données de référence LEI sous CC0, dans le domaine public, sans aucune restriction de licence sur l'usage en aval. C'est inhabituel pour des données d'entités, et c'est précisément la raison d'être de cet endpoint : la même recherche chez un fournisseur commercial s'accompagne généralement de conditions de redistribution.