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.

[ negócios · entidade ]● 3 créd. · 30 req/min

Consulta de entidade por LEI API

Identifique uma entidade jurídica no registro da GLEIF por código LEI ou por nome. Razão social oficial, endereços, jurisdição, número no registro comercial nacional, códigos BIC e vínculos de controladora e subsidiárias.

Oficial da GLEIFISO 17442CC0, domínio público

auth · x-api-key

API Key

Não tem uma API key?

Faça login na sua conta para criar e gerenciar suas API keys.

Entrar Gerenciar API keys

[ 02 · integrate ]

Guia de integração

Copie um trecho, troque sua API key e execute. Funciona em qualquer cliente HTTP — exemplos abaixo em cURL, JavaScript e 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 · resposta

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

Feita para Casos de Uso Reais

🔗

Resolução de entidades

Transforme um nome de empresa bagunçado no CRM em um identificador canônico que cruza sem ruído entre sistemas e jurisdições.

🏛️

KYC de contrapartes

Confirme razão social cadastrada, jurisdição e número de registro nacional de uma contraparte contra uma fonte oficial.

🌳

Mapeamento societário

Percorra os vínculos de controladora e subsidiárias para ver quem de fato controla uma entidade antes de conceder crédito ou assinar.

🤖

Agentes de pesquisa

Dê a um agente de pesquisa uma fonte de identidade citável, para que afirmações sobre entidades remetam a um registro em vez de a um palpite.

Campos da resposta

Campo	Tipo	Descrição
mode	string	Qual consulta foi executada: lei ou search
record.lei	string	O identificador ISO 17442 de 20 caracteres
record.legal_name	string \| null	Razão social oficial cadastrada
record.other_names	string[]	Nomes anteriores e alternativos constantes do registro
record.legal_address	object \| null	Endereço da sede legal, dividido em linhas, cidade, região, país e CEP
record.jurisdiction	string \| null	Jurisdição de constituição, ex.: US-CA
record.registered_as	string \| null	Número no registro comercial nacional — a ponte para os arquivamentos locais
record.entity_status	string \| null	ACTIVE ou INACTIVE
record.bic	string[]	Códigos SWIFT/BIC vinculados, quando a entidade possui algum
record.registration_status	string \| null	Situação no ciclo de vida do LEI, ex.: ISSUED ou LAPSED
relationships	object	Presente com include_relationships: controladora direta, controladora final e número de subsidiárias
total_matches	integer	Somente no modo de busca: quantos registros correspondem ao nome
credits_used	integer	Créditos deduzidos por esta requisição
remaining_credits	integer	Créditos restantes na sua conta

[ 03 · limits ]

Rate limits

O throttling é por API key, em janela deslizante de 60 segundos. Ao atingir o limite, você recebe um 429 limpo com um header Retry-After.

taxa de requisições

30req/min

Por API key, por endpoint. Janela deslizante de 60 segundos.

concorrência

3concurrent

Máximo de requisições simultâneas em andamento por API key.

headers de resposta

X-RateLimit-LimitMáximo de requisições permitidas por minuto

X-RateLimit-RemainingRequisições restantes na janela atual

X-RateLimit-ResetSegundos até a janela atual reiniciar

Retry-AfterSegundos a aguardar antes de tentar novamente (apenas em 429)

● 429 · requisições em excesso

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 dos dados e licença

Os registros vêm da GLEIF, a Global Legal Entity Identifier Foundation, que mantém o registro LEI em nome do Regulatory Oversight Committee. A GLEIF publica tanto os dados de referência de nível 1 quanto os dados societários de nível 2 sob CC0 — domínio público, sem exigência de atribuição e sem restrição de uso posterior.

Perguntas Frequentes

P: O que é um LEI e por que usá-lo como chave?

R: Um Legal Entity Identifier é um código ISO 17442 de 20 caracteres que identifica uma entidade jurídica no mundo todo — obrigatório para quem atua em mercados financeiros regulados. Diferente do nome da empresa, não é ambíguo; diferente de um número de registro nacional, não colide entre jurisdições, o que o torna a chave certa para resolver entidades.

P: Posso buscar sem conhecer o LEI?

R: Pode. Passe name em vez de lei para buscar no registro pela razão social, opcionalmente restringindo com country. O filtro por nome da GLEIF é uma correspondência por relevância, não exata, então total_matches pode ser alto — os registros retornados são o topo dessa lista.

P: Como obtenho a árvore societária do grupo?

R: Acrescente include_relationships=true a uma consulta por LEI. Você recebe a controladora direta, a controladora final e a contagem de subsidiárias diretas, cada controladora identificada pelo próprio LEI, para percorrer a árvore para cima ou para baixo com novas chamadas.

P: Quão atualizados são os dados?

R: A GLEIF publica diariamente uma nova cópia de referência do registro, e este endpoint consulta a API ao vivo deles, não um snapshot local. As entidades precisam renovar o LEI todo ano, então registration_status e next_renewal_date indicam se um registro está sendo mantido ou se venceu.

P: Os dados podem ser redistribuídos livremente?

R: A GLEIF publica os dados de referência do LEI sob CC0, em domínio público, sem qualquer restrição de licença para uso posterior. Isso é incomum em dados de entidades e é justamente a razão de existir deste endpoint — a mesma consulta em um fornecedor comercial costuma vir com condições de redistribuição.