GLEIF LEI API
Official vendor OpenAPI document · agent-readyData EnrichmentCompany Datanone8 EndpointsREST
For Agents
Validate and enrich legal entity records by looking up Legal Entity Identifiers (LEI), parent relationships, and issuing LOUs from the GLEIF reference dataset.
Use for: Look up the LEI record for the LEI 5493001KJTIIGC8Y1R12, Search the GLEIF registry for legal entities named 'Acme', Find the managing LOU for a given LEI, Retrieve the modification history of an LEI record
Not supported: Does not handle sanctions screening, credit ratings, or financial filings - use for Legal Entity Identifier reference data and ownership relationships only.
The GLEIF LEI API exposes the Global Legal Entity Identifier Foundation's reference dataset - every issued Legal Entity Identifier (LEI), the legal entity record behind it, the relationships to ultimate and direct parents, the managing Local Operating Unit (LOU), and field-level modification history. Agents can validate counterparties, enrich KYC and KYB workflows, and trace ownership relationships across the global LEI registry. The API is open, requires no authentication, and is served from api.gleif.org.
Install Jentic One Beta
Connect the GLEIF LEI API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GLEIF LEI API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgleif.org%2Fgleif" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgleif.org%2Fgleif" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with GLEIF LEI API.
Look up the LEI record for a legal entity by exact LEI code via /lei-records/{lei}
Search for entities by name, country, or status across the global LEI registry
Resolve the managing Local Operating Unit (LOU) for a given LEI
Resolve the LEI issuer record for a given LEI
Fetch field-level modification history for an LEI record
Autocomplete entity names for KYC and counterparty-search forms
List the LEI issuers (LOUs) accredited by GLEIF
Use Cases
Patterns agents use GLEIF LEI API for, with concrete tasks.
★ Counterparty KYB Verification
Verify a corporate counterparty during onboarding by resolving its LEI to the GLEIF reference record. GET /lei-records/{lei} returns the legal name, registration jurisdiction, status, and the next renewal date - enough to confirm the entity exists, is current, and matches the data the customer supplied.
Fetch /lei-records/5493001KJTIIGC8Y1R12 and return legalName, jurisdiction, registrationStatus, and nextRenewalDate
Beneficial Ownership Tracing
Trace a legal entity's parent and ultimate parent for AML or sanctions screening. The relationship endpoints under /lei-records/{lei} expose direct and ultimate parent LEIs, which an agent can recursively resolve through GLEIF until it reaches the top of the ownership chain.
Starting from LEI X, fetch the ultimate parent LEI, resolve it via /lei-records/{lei}, and return the parent's legalName
Counterparty Search Autocomplete
Power an autocomplete dropdown when a user is typing a legal entity name into a counterparty form. /autocompletions returns matching candidates by name fragment with their LEIs, so the agent can return a structured list rather than a free-text guess.
Call /autocompletions with field=fulltext and q='Goldman' and return up to 5 (legalName, lei) pairs
AI Agent KYC Enrichment
Use Jentic to let an AI agent enrich freshly added counterparty rows in a CRM. The agent issues an intent like 'look up an LEI by company name', Jentic resolves the GLEIF /autocompletions and /lei-records/{lei} calls, and the agent writes the legal name, jurisdiction, and parent LEI back to the CRM record.
Through Jentic, autocomplete 'Acme Corp', resolve the top LEI via /lei-records/{lei}, and return jurisdiction and registrationStatus
Key Endpoints
8 endpoints — the gleif lei api exposes the global legal entity identifier foundation's reference dataset - every issued legal entity identifier (lei), the legal entity record behind it, the relationships to ultimate and direct parents, the managing local operating unit (lou), and field-level modification history.
METHOD
PATH
DESCRIPTION
GET
/lei-records
Search LEI records with filters
GET
/lei-records/{lei}
Fetch a single LEI record
GET
/lei-records/{lei}/managing-lou
Get the managing LOU for an LEI
GET
/lei-records/{lei}/lei-issuer
Get the issuer of an LEI
GET
/lei-records/{lei}/field-modifications
Field-level modification history
GET
/autocompletions
Autocomplete entity names
GET
/lei-issuers
List accredited LEI issuers
GET
/lei-records
Search LEI records with filters
GET
/lei-records/{lei}
Fetch a single LEI record
GET
/lei-records/{lei}/managing-lou
Get the managing LOU for an LEI
GET
/lei-records/{lei}/lei-issuer
Get the issuer of an LEI
GET
/lei-records/{lei}/field-modifications
Field-level modification history
GET
/autocompletions
Autocomplete entity names
GET
/lei-issuers
List accredited LEI issuers
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the GLEIF LEI API by hand means reading its record structure and relationship endpoints and building the query and pagination handling yourself, even though it needs no credential. Through Jentic you install once, import the GLEIF LEI API from the API Directory, and your agent calls it.
Permission scoping
GLEIF exposes read-only public reference data with the LEI in the URL path (/lei-records/{lei}), so scope the agent to the operations it needs, such as looking up an LEI record or its managing LOU. You choose that operation set, so it reads reference data and ownership relationships without any write ability.
Credential isolation
The GLEIF LEI API needs no credential, so Jentic orchestrates the call without storing a secret; any other API secrets your agent uses are stored once, encrypted, by your own Jentic One instance and injected at execution time, never entering the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'look up an LEI' or 'find a legal entity's issuer', and Jentic returns the matching GLEIF operation with its query parameter schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using GLEIF LEI API through Jentic.
What authentication does the GLEIF LEI API use?
The GLEIF LEI API is open and requires no API key or token; the spec defines no security scheme. Through Jentic the API can still be called via the standard search/load/execute flow without provisioning a credential, which is useful when wiring up KYC enrichment for an agent.
Can I look up a Legal Entity Identifier with the GLEIF API?
Yes. GET /lei-records/{lei} returns the canonical record for a single LEI, including legal name, registration jurisdiction, status (ISSUED, LAPSED, etc.), and the next renewal date. Use it as the source of truth for validating that an LEI on a counterparty form is real and current.
What are the rate limits for the GLEIF LEI API?
GLEIF asks integrators to be considerate and avoid sustained bursts above a few requests per second from a single source. There is no documented numeric cap; if you receive HTTP 429 or 503 in batch enrichment, back off and process more slowly or distribute work across IPs.
How do I autocomplete a company name through Jentic with GLEIF?
Search Jentic for 'autocomplete legal entity name', load GET /autocompletions, and execute with field=fulltext and q set to the partial name. The response returns matching LEIs and legal names that an agent can present to the user before resolving the full record via /lei-records/{lei}.
Can the GLEIF API return parent and ultimate-parent relationships?
Yes. The /lei-records/{lei} response embeds direct-parent and ultimate-parent relationship links, and the related-records endpoints under that path return the full relationship records. An agent can recurse upward to build the ownership chain for AML or sanctions checks.
Is the GLEIF LEI API free?
Yes. GLEIF publishes the LEI dataset as an open data product under a CC0-style licence, and the v1 API at api.gleif.org is freely accessible. There is no commercial paywall on read endpoints; the cost is in obtaining and renewing the LEIs themselves through accredited LOUs.
Can I limit what my agent is allowed to do with the GLEIF LEI API?
Yes. Because Jentic One is self-hosted, you set the rules that decide which operations and credentials your agent may use, so you can allow only the read calls it needs, such as GET /lei-records/{lei} for a single LEI record or /lei-records/{lei}/managing-lou for the issuing LOU, while withholding search or autocomplete. The GLEIF LEI API is read-only public reference data with the LEI in the URL path, so a scoped agent reads entity records and ownership relationships without any write ability. You choose that operation set, keeping the agent to lookups you have explicitly permitted.
GET STARTED