GLEIF (LEI)

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.

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`.

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 }

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.

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`.

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).

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Countries

Search entities

One entity and its parents

Search relationships

Full reference

​Search entities

​One entity and its parents

​Search relationships

Full reference

Search entities

One entity and its parents

Search relationships