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.

[ business · soggetto ]● 3 cred. · 30 richieste/min

Ricerca soggetto giuridico LEI

Individua un soggetto giuridico nel registro GLEIF per codice LEI o per denominazione. Ragione sociale ufficiale, indirizzi, giurisdizione, numero di iscrizione al registro imprese nazionale, codici BIC e legami con capogruppo e controllate.

Ufficiale GLEIFISO 17442CC0, pubblico dominio

auth · x-api-key

API Key

Non hai una API key?

Accedi al tuo account per creare e gestire le tue API key.

Accedi Gestisci API key

[ 02 · integrate ]

Guida all'integrazione

Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e Python.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parametri

leistringfacoltativo

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

namestringfacoltativo

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

countrystringfacoltativo

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

include_relationshipsbooleanfacoltativo

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

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

Costruita per casi d'uso reali

🔗

Risoluzione dei soggetti

Trasforma una denominazione societaria disomogenea nel CRM in un identificativo canonico che si aggancia senza attriti tra sistemi e giurisdizioni.

🏛️

KYC sulle controparti

Conferma denominazione registrata, giurisdizione e numero di iscrizione nazionale di una controparte confrontandoli con una fonte ufficiale.

🌳

Mappatura societaria

Percorri i legami tra capogruppo e controllate per capire chi controlla davvero un soggetto prima di concedere credito o firmare.

🤖

Agenti di ricerca

Dai a un agente di ricerca una fonte identificativa citabile, così le affermazioni sui soggetti rimandano a un registro invece che a una supposizione.

Campi della risposta

Campo	Tipo	Descrizione
mode	string	Quale interrogazione è stata eseguita: lei o search
record.lei	string	L'identificativo ISO 17442 di 20 caratteri
record.legal_name	string \| null	Ragione sociale ufficiale registrata
record.other_names	string[]	Denominazioni precedenti e alternative presenti nel registro
record.legal_address	object \| null	Sede legale, suddivisa in righe, città, regione, Paese e CAP
record.jurisdiction	string \| null	Giurisdizione di costituzione, ad es. US-CA
record.registered_as	string \| null	Numero nel registro imprese nazionale: il ponte verso i depositi locali
record.entity_status	string \| null	ACTIVE o INACTIVE
record.bic	string[]	Codici SWIFT/BIC associati, se il soggetto ne ha
record.registration_status	string \| null	Stato del ciclo di vita del LEI, ad es. ISSUED o LAPSED
relationships	object	Presente con include_relationships: capogruppo diretta, capogruppo ultima e numero di controllate
total_matches	integer	Solo in modalità ricerca: quanti record corrispondono alla denominazione
credits_used	integer	Crediti scalati per questa richiesta
remaining_credits	integer	Crediti rimanenti nel tuo account

[ 03 · limits ]

Limiti di frequenza

Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.

frequenza richieste

30req/min

Per API key e per endpoint. Finestra mobile di 60 secondi.

concorrenza

3concurrent

Numero massimo di richieste simultanee in corso per API key.

header di risposta

X-RateLimit-LimitNumero massimo di richieste consentite al minuto

X-RateLimit-RemainingRichieste rimanenti nella finestra corrente

X-RateLimit-ResetSecondi al reset della finestra corrente

Retry-AfterSecondi da attendere prima di riprovare (solo in caso di 429)

● 429 · troppe richieste

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
}

Fonte dei dati e licenza

I record provengono da GLEIF, la Global Legal Entity Identifier Foundation, che gestisce il registro LEI per conto del Regulatory Oversight Committee. GLEIF pubblica sia i dati di riferimento di livello 1 sia i dati proprietari di livello 2 con licenza CC0: pubblico dominio, senza obbligo di attribuzione e senza vincoli sull'uso successivo.

Domande frequenti

D: Che cos'è un LEI e perché usarlo come chiave?

R: Il Legal Entity Identifier è un codice ISO 17442 di 20 caratteri che identifica un singolo soggetto giuridico in tutto il mondo ed è obbligatorio per chi opera sui mercati finanziari regolamentati. A differenza della denominazione non è ambiguo e, a differenza di un numero di iscrizione nazionale, non entra in conflitto tra giurisdizioni: per questo è la chiave giusta per collegare i soggetti.

D: Posso cercare senza conoscere il LEI?

R: Sì. Passa name invece di lei per cercare nel registro per denominazione, eventualmente restringendo con country. Il filtro per denominazione di GLEIF è una corrispondenza per rilevanza e non esatta, quindi total_matches può essere elevato: i record restituiti sono la parte alta di quella graduatoria.

D: Come ottengo l'albero societario del gruppo?

R: Aggiungi include_relationships=true a una ricerca per LEI. Ottieni la capogruppo diretta, la capogruppo ultima e il numero di controllate dirette, con ciascuna capogruppo identificata dal proprio LEI, così puoi percorrere l'albero verso l'alto o verso il basso con ulteriori chiamate.

D: Quanto sono aggiornati i dati?

R: GLEIF pubblica ogni giorno una nuova copia di riferimento del registro e questo endpoint interroga la loro API in tempo reale, non uno snapshot locale. I soggetti devono rinnovare il LEI ogni anno, quindi registration_status e next_renewal_date ti dicono se un record è mantenuto attivamente o è scaduto.

D: I dati sono liberamente ridistribuibili?

R: GLEIF pubblica i dati di riferimento LEI con licenza CC0, in pubblico dominio, senza alcun vincolo di licenza sull'uso successivo. È insolito per i dati sui soggetti giuridici ed è proprio la ragione d'essere di questo endpoint: la stessa ricerca presso un fornitore commerciale porta di norma con sé condizioni di ridistribuzione.