# GLEIF LEI Company Register API

> 2.9M+ legal entities worldwide by LEI: names, addresses, registration and parent companies

- Vendor: `gleifleicompanyregisterapi` · version 1.0 · category Business · tags lei api, gleif api, legal entity api, company ownership api, parent company api, kyb api, company register api, isin to lei api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/gleifleicompanyregisterapi
- This document: https://apiclay.com/docs/gleifleicompanyregisterapi.md
- OpenAPI 3.1: https://apiclay.com/api/gleifleicompanyregisterapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `gleifleicompanyregisterapi`
- Updated: 2026-11-18

## About

## GLEIF LEI Company Register API

Look up any of the 2.9M+ legal entities that hold a Legal Entity Identifier (LEI): legal name, legal and headquarters address, registration authority and number, legal form, status, and who owns whom (direct and ultimate parents and children), plus the ISINs an entity has issued.

Data comes from **gleif.org** (https://search.gleif.org). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://search.gleif.org) and returns it unchanged.

Typical flow: `/search` or `/autocomplete` to find the LEI, then `/record`, the parent/children routes and `/isins`.

### Routes

#### GET `/search` - Search legal entities
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| filter[fulltext] | query | string | no | Any name, LEI or registration number. |
| filter[entity.legalName] | query | string | no | Exact legal name. |
| filter[entity.legalAddress.country] | query | string | no | ISO 3166 code, e.g. `US`. |
| filter[entity.status] | query | string | no | `ACTIVE` or `INACTIVE`. |
| filter[registration.status] | query | string | no | e.g. `ISSUED`, `LAPSED`. |
| page[size] | query | number | no | Up to 200 (default 15). |
| page[number] | query | number | no | Page, from 1. |

Returns: `data[]` with `id` (the LEI) and `attributes.entity` (`legalName`, `legalAddress`, `headquartersAddress`, `registeredAt`, `registeredAs`, `jurisdiction`, `legalForm`, `status`, `creationDate`), `attributes.registration`, and `meta.pagination`.

#### GET `/record` - Entity by LEI
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lei | path | string | yes | 20-character LEI, e.g. `HWUPKR0MPOU8FGXBT394`. |

Returns: `data` as above plus `relationships` links.

#### GET `/direct-parent`, `/ultimate-parent` - Parent company
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lei | path | string | yes | Child entity's LEI. |

Returns: the parent's record in `data`. A 404 means no parent is reported (or an exception reason is recorded instead).

#### GET `/direct-children`, `/ultimate-children` - Subsidiaries
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lei | path | string | yes | Parent entity's LEI. |
| page[size] | query | number | no | Up to 200. |
| page[number] | query | number | no | Page, from 1. |

Returns: `data[]` child records and `meta.pagination`.

#### GET `/isins` - Securities issued
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lei | path | string | yes | Issuer's LEI. |
| page[size] | query | number | no |  |
| page[number] | query | number | no |  |

Returns: `data[]` with `attributes.isin`.

#### GET `/autocomplete` - Name autocomplete
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Start of a name, e.g. `apple`. |

Returns: `data[]` with `attributes.value` and the matching LEI in `relationships.lei-records.data.id`.

### License

LEI data is published by GLEIF under CC0 1.0 (no restrictions).

### Caveats

- Only entities that registered for an LEI (banks, funds, listed and many trading companies) are covered; small private companies often are not.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by gleif.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search legal entities
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/search`
- Public query params: `filter[fulltext]` (string), `filter[entity.legalName]` (string), `filter[entity.legalAddress.country]` (string), `filter[entity.status]` (string), `filter[registration.status]` (string), `page[size]` (number), `page[number]` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /record — Entity by LEI
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/record`
- Public query params: `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /direct-parent — Direct parent
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/direct-parent`
- Public query params: `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /ultimate-parent — Ultimate parent
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/ultimate-parent`
- Public query params: `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /direct-children — Direct children
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/direct-children`
- Public query params: `page[size]` (number), `page[number]` (number), `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /ultimate-children — Ultimate children
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/ultimate-children`
- Public query params: `page[size]` (number), `page[number]` (number), `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /isins — ISINs of an entity
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/isins`
- Public query params: `page[size]` (number), `page[number]` (number), `lei` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /autocomplete — Name autocomplete
- Gateway: `GET https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/autocomplete`
- Public query params: `q` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/gleifleicompanyregisterapi/search" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
