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.

[ negocio · entidad ]● 3 créd. · 30 sol./min

Consulta de entidades LEI API

Resuelve una entidad jurídica en el registro GLEIF por código LEI o por nombre. Razón social oficial, direcciones, jurisdicción, número de registro mercantil nacional, códigos BIC y vínculos de matriz y filiales.

Oficial de GLEIFISO 17442CC0, dominio público

auth · x-api-key

Clave API

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

Iniciar sesión Gestionar claves API

[ 02 · integrate ]

Guía de integración

Copia un fragmento, sustituye tu clave de API y ejecútalo. Funciona en cualquier cliente HTTP — ejemplos abajo en cURL, JavaScript y Python.

spec

GET/api/lei-lookup

base

https://www.apipick.com

Resolve a legal entity through the GLEIF LEI register

parámetros

leistringopcional

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

namestringopcional

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

countrystringopcional

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

include_relationshipsbooleanopcional

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

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

Diseñada para casos de uso reales

🔗

Resolución de entidades

Convierte un nombre de empresa desordenado en un CRM en un identificador canónico que cruza limpiamente entre sistemas y jurisdicciones.

🏛️

KYC de contrapartes

Confirma la razón social registrada, la jurisdicción y el número mercantil nacional de una contraparte frente a una fuente oficial.

🌳

Mapa de propiedad

Recorre los vínculos de matriz y filiales para ver quién controla en última instancia una entidad antes de conceder crédito o firmar.

🤖

Agentes de investigación

Da a un agente de investigación una fuente de identidad citable, para que sus afirmaciones sobre entidades remitan a un registro y no a una conjetura.

Campos de la respuesta

Campo	Tipo	Descripción
mode	string	Qué consulta se ejecutó: lei o search
record.lei	string	El identificador ISO 17442 de 20 caracteres
record.legal_name	string \| null	Razón social oficial registrada
record.other_names	string[]	Nombres anteriores y alternativos que constan en el registro
record.legal_address	object \| null	Domicilio social, desglosado en líneas, ciudad, región, país y código postal
record.jurisdiction	string \| null	Jurisdicción de constitución, p. ej. US-CA
record.registered_as	string \| null	Número en el registro mercantil nacional: el puente hacia las cuentas depositadas localmente
record.entity_status	string \| null	ACTIVE o INACTIVE
record.bic	string[]	Códigos SWIFT/BIC asociados, si la entidad tiene alguno
record.registration_status	string \| null	Estado del ciclo de vida del LEI, p. ej. ISSUED o LAPSED
relationships	object	Presente con include_relationships: matriz directa, matriz última y número de filiales
total_matches	integer	Solo en modo búsqueda: cuántos registros coinciden con el nombre
credits_used	integer	Créditos descontados por esta solicitud
remaining_credits	integer	Créditos restantes en tu cuenta

[ 03 · limits ]

Límites de tasa

La limitación es por clave de API, ventana deslizante de 60 segundos. Al alcanzar el límite recibes un 429 limpio con una cabecera Retry-After.

tasa de peticiones

30req/min

Por clave de API, por endpoint. Ventana deslizante de 60 segundos.

concurrencia

3concurrent

Máximo de peticiones simultáneas en curso por clave de API.

cabeceras de respuesta

X-RateLimit-LimitMáximo de peticiones permitidas por minuto

X-RateLimit-RemainingPeticiones restantes en la ventana actual

X-RateLimit-ResetSegundos hasta que se reinicia la ventana actual

Retry-AfterSegundos a esperar antes de reintentar (solo en 429)

● 429 · demasiadas peticiones

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
}

Fuente de datos y licencia

Los registros proceden de GLEIF, la Global Legal Entity Identifier Foundation, que mantiene el registro LEI por encargo del Comité de Supervisión Regulatoria. GLEIF publica tanto los datos de referencia de nivel 1 como los de propiedad de nivel 2 bajo CC0: dominio público, sin atribución obligatoria ni restricción alguna sobre el uso posterior.

Preguntas frecuentes

P: ¿Qué es un LEI y por qué usarlo como clave?

R: Un Identificador de Entidad Jurídica es un código ISO 17442 de 20 caracteres que identifica a una entidad jurídica en todo el mundo, obligatorio para quien opera en mercados financieros regulados. A diferencia del nombre de una empresa no es ambiguo, y a diferencia de un número de registro nacional no colisiona entre jurisdicciones, lo que lo convierte en la clave adecuada para resolver entidades.

P: ¿Puedo buscar sin conocer el LEI?

R: Sí. Pasa name en lugar de lei para buscar en el registro por razón social, y acota si quieres con country. El filtro por nombre de GLEIF es una coincidencia por relevancia, no exacta, así que total_matches puede ser alto: los registros devueltos son la cabecera ordenada de esa lista.

P: ¿Cómo obtengo el árbol de propiedad del grupo?

R: Añade include_relationships=true a una consulta por LEI. Obtendrás la matriz directa, la matriz última y el número de filiales directas, cada matriz identificada por su propio LEI para que puedas recorrer el árbol hacia arriba o hacia abajo con más llamadas.

P: ¿Cómo de actualizados están los datos?

R: GLEIF publica a diario una nueva copia maestra del registro, y este endpoint consulta su API en vivo, no una instantánea local. Las entidades deben renovar su LEI cada año, de modo que registration_status y next_renewal_date te dicen si un registro se mantiene activo o ha caducado.

P: ¿Se pueden redistribuir libremente los datos?

R: GLEIF publica los datos de referencia del LEI bajo CC0, en el dominio público, sin restricción de licencia sobre el uso posterior. Eso es poco habitual en datos de entidades y es la razón de ser de este endpoint: la misma consulta con un proveedor comercial suele llevar condiciones de redistribución.