> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GLEIF (LEI)
> Every Legal Entity Identifier in the world, about 3.4 million: the entity's names, addresses, jurisdiction, legal form, business register number, status and events, the parents it reports (direct and ultimate consolidation, fund manager, umbrella fund, head office) and why it reports none when it does not.
A Legal Entity Identifier is the 20-character code that identifies a legal
entity in financial transactions and regulatory reporting worldwide. Banks,
funds, issuers, their subsidiaries and a growing share of ordinary companies
hold one. Each LEI record says who the entity is (names, addresses, legal
jurisdiction and form), where it is registered and under which number, and
which entities own it: the direct and ultimate parents that consolidate it in
their accounts, the fund manager or umbrella fund of a fund, the head office
of a branch. When an entity reports no parent, the record says why (owned by
people, not consolidated, no known person).
Every LEI record, relationship and reporting exception, brought up to date
three times a day. The register number is what joins an LEI to a business
register: a Delaware file number, a Sunbiz document number, a NIT.
| `registration_authority` | Register | `registered_as` |
| ------------------------ | --------------------------------------------------------- | ---------------------------------------- |
| `RA000602` | Delaware Division of Corporations | The file number, e.g. `2758229` |
| `RA000603` | Florida Division of Corporations (Sunbiz) | The document number, e.g. `L09000050533` |
| `RA999999` | No register reported | |
| `RA888888` | Another register, named in `other_registration_authority` | |
LEI data from GLEIF, the Global Legal Entity Identifier Foundation, under CC0 1.0.
Croma is not affiliated with GLEIF, and GLEIF does not endorse or supply this
service.
The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
## Search entities
`POST /global/gleif/entities-search/v1` Dataset
Searches every LEI record by any combination of name, place, register number,
category and status.
| Field | Type | Notes |
| ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional. Words in the legal name or any other name the record carries. Every word must match; no stemming. |
| `country` | string | Optional. The two-letter country of the legal address, e.g. `US`, `CO`, `KY`. |
| `jurisdiction` | string | Optional. The legal jurisdiction: a country (`GB`) or a subdivision (`US-DE`, `US-FL`). |
| `registration_authority` | string | Optional. The business register, by GLEIF's code (the table above). |
| `registered_as` | string | Optional. The entity's number at its register, e.g. a Delaware file number. Pair it with `registration_authority` to find the LEI of a company you know from the register. |
| `category` | enum | Optional. `GENERAL`, `FUND`, `BRANCH`, `SOLE_PROPRIETOR`, `RESIDENT_GOVERNMENT_ENTITY` or `INTERNATIONAL_ORGANIZATION`. |
| `entity_status` | enum | Optional. `ACTIVE` or `INACTIVE`. |
| `registration_status` | enum | Optional. The LEI's status: `ISSUED` (kept up to date), `LAPSED` (not renewed), `RETIRED`, `DUPLICATE`, `ANNULLED`, `MERGED`, `PENDING_TRANSFER` or `PENDING_ARCHIVAL`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-50. Default `20`. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/entities-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "bancolombia" }'
```
Returns `as_of`, the applied filters, `total`, `page`, `per_page`, `total_pages`, `count` and `entities[]`, by legal name.
Every entity carries `lei`, `legal_name`, `legal_name_language`, `other_names[]` and `transliterated_names[]` (`{ name, language, type }`), `all_names[]`, `legal_address` and `headquarters_address` (`{ first_line, number, number_within_building, mail_routing, additional_lines[], city, region, country, postal_code, language }`), `other_addresses[]` and `transliterated_addresses[]` (the same, with a `type`), `country`, `jurisdiction`, `registration_authority`, `other_registration_authority`, `registered_as`, `category`, `sub_category`, `legal_form_code` (ISO 20275), `other_legal_form`, `associated_entity`, `entity_status`, `creation_date`, `expiration_date`, `expiration_reason`, `successor_entities[]`, `events[]` (legal entity events: name changes, mergers, dissolutions, with the fields each affected), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_authority`, `other_validation_authorities[]` and `conformity_flag`.
Empty fields are `null`. Dates are UTC ISO 8601.
## One entity and its parents
`POST /global/gleif/entity/v1` Dataset
Resolves one LEI and returns the record, its parents and its children.
| Field | Type | Notes |
| ----- | ------ | ----------------------------------- |
| `lei` | string | **Required.** The 20-character LEI. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/entity/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "lei": "HWUPKR0MPOU8FGXBT394" }'
```
Returns `found`, `lei`, `as_of`, `entity` (null when not found), `direct_parent` and `ultimate_parent` (each a relationship with `parent_name`, or null), `other_parents[]` (fund manager, umbrella fund, master fund, head office), `reporting_exceptions[]` (`{ category, reasons[], exception_references[] }`: why no parent is reported), `children[]` (up to 100 relationships that name this entity as parent, with `child_name`, current ones first) and `children_total`.
Every entity carries `lei`, `legal_name`, `legal_name_language`, `other_names[]` and `transliterated_names[]` (`{ name, language, type }`), `all_names[]`, `legal_address` and `headquarters_address` (`{ first_line, number, number_within_building, mail_routing, additional_lines[], city, region, country, postal_code, language }`), `other_addresses[]` and `transliterated_addresses[]` (the same, with a `type`), `country`, `jurisdiction`, `registration_authority`, `other_registration_authority`, `registered_as`, `category`, `sub_category`, `legal_form_code` (ISO 20275), `other_legal_form`, `associated_entity`, `entity_status`, `creation_date`, `expiration_date`, `expiration_reason`, `successor_entities[]`, `events[]` (legal entity events: name changes, mergers, dissolutions, with the fields each affected), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_authority`, `other_validation_authorities[]` and `conformity_flag`.
Empty fields are `null`. Dates are UTC ISO 8601.
Every relationship carries `id`, `child_lei`, `parent_lei`, `relationship_type`, `relationship_status`, `periods[]` (`{ start_date, end_date, type }`), `qualifiers[]` (the accounting standard), `quantifiers[]` (the consolidation percentage), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_documents`, `validation_reference`, `current` and `withdrawn_at` (when GLEIF withdrew it, if it has).
## Search relationships
`POST /global/gleif/relationships-search/v1` Dataset
Lists the relationships of a child, of a parent, or of a kind.
| Field | Type | Notes |
| ------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `child_lei` | string | Optional. The LEI of the entity that reports the relationship. |
| `parent_lei` | string | Optional. The LEI of the parent, to list everything that reports it. |
| `relationship_type` | enum | Optional. `IS_DIRECTLY_CONSOLIDATED_BY`, `IS_ULTIMATELY_CONSOLIDATED_BY`, `IS_INTERNATIONAL_BRANCH_OF`, `IS_FUND-MANAGED_BY`, `IS_SUBFUND_OF` or `IS_FEEDER_TO`. |
| `include_inactive` | boolean | Optional. `true` to include the relationships GLEIF has withdrawn. Default `false`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-50. Default `20`. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/relationships-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "parent_lei": "HWUPKR0MPOU8FGXBT394" }'
```
Returns `as_of`, the applied filters, `total`, `page`, `per_page`, `total_pages`, `count` and `relationships[]`.
Every relationship carries `id`, `child_lei`, `parent_lei`, `relationship_type`, `relationship_status`, `periods[]` (`{ start_date, end_date, type }`), `qualifiers[]` (the accounting standard), `quantifiers[]` (the consolidation percentage), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_documents`, `validation_reference`, `current` and `withdrawn_at` (when GLEIF withdrew it, if it has).
Schemas, all response fields, and an interactive playground.