# lei.online

> The public surface of a GLEIF-accredited LEI issuer. Search the Global LEI Index and the national company register behind it, read one entity's record, and see the size and motion of the register. Anonymous and read-only: no key, no account, no registration.

The Legal Entity Identifier is a twenty-character code identifying one legal entity anywhere in the world, issued by an accredited organisation and published by the Global Legal Entity Identifier Foundation as open data.

## API

- [OpenAPI document](https://lei.online/openapi.json): every endpoint below, generated from the handlers that serve them.
- [MCP endpoint](https://lei.online/mcp): the same questions as MCP tools, over Streamable HTTP. POST only; the transport is stateless and has no session.

## Endpoints

- [Search](https://lei.online/v1/search?q=volvo): both collections at once, merged and deduplicated. `q`, `limit`, `page`.
- [One LEI record](https://lei.online/v1/entities/549300HGV012CNC8JD22): by identifier, checksum-checked before it is looked up.
- [One company record](https://lei.online/v1/companies/5560125790): by registration number, with its LEI when it holds one.
- [Register pulse](https://lei.online/v1/pulse): how many identifiers are live, the rate they are issued at, and the newest records.

## Browsing, when there is no one entity in mind yet

Search answers *find me this one*. These answer *what is in here, and how much of it* - which is the question an agent enumerating the register actually has, and the one it otherwise has to guess country codes to ask.

- [Directory](https://lei.online/v1/directory): every group with a live count. Three over the Global LEI Index - country, issuing LOU, legal form - and three over the national company corpus: county, municipality, industry.
- [One group](https://lei.online/v1/directory/country/SE): a page of what is in it. Take the facet and the key from the directory above; a key invented rather than read back returns nothing.
- [Recently issued](https://lei.online/v1/recent): newest first, worldwide or `?country=SE`. The one view of the register that changes hour to hour.

Every group is also a page a person can read, at `/en/country/sweden`, `/en/municipality/harnosand` and so on, with the Swedish spellings under `/sv/land/`, `/sv/kommun/` and `/sv/bransch/`. The two hubs those hang from are `/en/lei` for the index and `/en/company/se` for the corpus.

## What this surface does not do

An identifier cannot be ordered, transferred or renewed here. GLEIF requires a verified authorised representative of the legal entity, so an order is prepared on the site and approved by that person from a link sent to their own email address. An agent can prepare one; it cannot approve one.