---
canonical_url: "https://docs.composio.dev/toolkits/gleif"
markdown_url: "https://docs.composio.dev/toolkits/gleif.md"
product: "platform"
version: null
last_updated: null
---

# GLEIF API

GLEIF provides free public access to Legal Entity Identifier records, ownership relationships, identifier mappings, and related reference data.

- **Category:** legal & public records
- **Auth:** NO_AUTH
- **Composio-managed OAuth available?** N/A
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `GLEIF`
- **Version:** 20261014_00

## Tools

### Export LEI Records

**Slug:** `GLEIF_EXPORT_LEI_RECORDS`

Download up to 5,000 LEI records using the complete closed field-filter and sort surface as CSV, XLSX, JSON, or XML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bic` | string | No | Legacy BIC mapping filter. |
| `isin` | string | No | Legacy ISIN mapping filter. |
| `sort` | string | No | Typed sort or the legacy provider sort expression. |
| `format` | string ("csv" | "xlsx" | "json" | "xml") | No | Export file format. |
| `filters` | array | No | Closed field-aware filters. Each field may appear only once. |
| `owns_lei` | string | No | Return the reported parent of this child LEI. |
| `full_text` | string | No | Broad text search across indexed LEI fields. |
| `lei_codes` | array | No | Legacy exact LEI-code filter. |
| `legal_name` | string | No | Legacy legal-name match filter. |
| `max_records` | integer | No | Maximum exported records (1-5000). |
| `owned_by_lei` | string | No | Return entities reported as children of this parent LEI. |
| `registration_status` | string ("ISSUED" | "LAPSED" | "ANNULLED" | "DUPLICATE" | "RETIRED" | "PENDING_ARCHIVAL" | "PENDING_TRANSFER" | "MERGED") | No | Legacy registration-status filter. |
| `legal_address_country` | string | No | Legacy legal-address country filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Autocompletions

**Slug:** `GLEIF_GET_AUTOCOMPLETIONS`

Return prefix-based GLEIF search suggestions from the provider's data collection, defaulting absent top-level metadata and links to empty objects. Highlighting is untrusted provider HTML and must be sanitized before rendering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | string ("fulltext" | "owns" | "ownedBy") | Yes | GLEIF autocomplete field: fulltext, owns, or ownedBy. |
| `query` | string | Yes | Partial text to complete (1-255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fund or Branch Relationship

**Slug:** `GLEIF_GET_FUND_OR_BRANCH_RELATIONSHIP`

Get the complete relationship record linking an LEI to its fund manager, umbrella fund, master fund, or head office.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The entity's 20-character Legal Entity Identifier. |
| `relation` | string ("fund_manager" | "umbrella_fund" | "master_fund" | "head_office") | Yes | Singular fund or branch relationship to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fuzzy Completions

**Slug:** `GLEIF_GET_FUZZY_COMPLETIONS`

Find approximate GLEIF search matches for misspelled or incomplete input. Results are complete provider resources from the data-only collection when no top-level metadata or links are supplied; they are fragments, not full LEI records or proof of identity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | string ("entity.legalName" | "fulltext" | "owns" | "ownedBy") | Yes | GLEIF field to search approximately: legal name, full text, ownership target, or owned entities. |
| `query` | string | Yes | Incomplete, misspelled, or approximate text to match (1-255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get LEI Issuer for Record

**Slug:** `GLEIF_GET_LEI_ISSUER_FOR_RECORD`

Get the complete LEI-issuer reference resource associated with a specified LEI record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The record's 20-character Legal Entity Identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get LEI Record

**Slug:** `GLEIF_GET_LEI_RECORD`

Retrieve one LEI record with complete provider attributes, relationships, links, and Golden Copy metadata when its LEI is known.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The entity's 20-character Legal Entity Identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Parent Information

**Slug:** `GLEIF_GET_PARENT_INFORMATION`

Get a direct or ultimate parent LEI plus complete relationship evidence, or the complete reporting exception when no parent is reported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI of the child entity. |
| `parent_level` | string ("direct" | "ultimate") | No | Retrieve the closest direct or furthest ultimate accounting parent. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Reference Item

**Slug:** `GLEIF_GET_REFERENCE_ITEM`

Get one complete item from a selected GLEIF reference collection by its collection-specific identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Collection-specific resource identifier. |
| `reference_type` | string ("fields" | "countries" | "entity_legal_forms" | "official_organizational_roles" | "jurisdictions" | "regions" | "registration_authorities" | "lei_issuers" | "vlei_issuers" | "registration_agents") | Yes | Closed reference collection selector. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Related LEI Record

**Slug:** `GLEIF_GET_RELATED_LEI_RECORD`

Follow a selected associated-entity, managing-LOU, fund, or head-office link and return the complete related LEI record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI whose related record should be followed. |
| `relation` | string ("associated_entity" | "managing_lou" | "fund_manager" | "umbrella_fund" | "master_fund" | "head_office") | Yes | The fixed associated-entity, managing-LOU, fund, or head-office relation to follow. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Successor Entity (Deprecated)

**Slug:** `GLEIF_GET_SUCCESSOR_ENTITY`

Deprecated compatibility lookup that returns only the first successor LEI. Use GLEIF_LIST_SUCCESSOR_ENTITIES for complete current successor data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI whose first successor should be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Child Entities

**Slug:** `GLEIF_LIST_CHILD_ENTITIES`

List one page of complete direct or ultimate accounting-child LEI records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI of the parent entity. |
| `page_size` | integer | No | Maximum child records in this page (1-200). |
| `child_level` | string ("direct" | "ultimate") | No | List immediate direct or ultimate-level accounting children. |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Child Relationships

**Slug:** `GLEIF_LIST_CHILD_RELATIONSHIPS`

List one page of complete direct or ultimate accounting-child relationship records for an LEI.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI of the parent entity. |
| `page_size` | integer | No | Maximum relationship records in this page (1-200). |
| `child_level` | string ("direct" | "ultimate") | No | List direct or ultimate accounting-child relationship records. |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fund or Branch Entities

**Slug:** `GLEIF_LIST_FUND_OR_BRANCH_ENTITIES`

List one page of complete managed-fund, sub-fund, feeder-fund, or international-branch LEI records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The entity's 20-character Legal Entity Identifier. |
| `relation` | string ("managed_funds" | "sub_funds" | "feeder_funds" | "branches") | Yes | Plural related LEI collection to list. |
| `page_size` | integer | No | Maximum LEI resources in this page (1-200). |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fund or Branch Relationships

**Slug:** `GLEIF_LIST_FUND_OR_BRANCH_RELATIONSHIPS`

List one page of complete fund-management, sub-fund, feeder-fund, or international-branch relationship records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The entity's 20-character Legal Entity Identifier. |
| `relation` | string ("managed_funds" | "sub_funds" | "feeder_funds" | "branches") | Yes | Plural raw relationship collection to list. |
| `page_size` | integer | No | Maximum relationship resources in this page (1-200). |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List LEI Field Modifications

**Slug:** `GLEIF_LIST_LEI_FIELD_MODIFICATIONS`

List one page of complete LEI, relationship, or reporting-exception field-history resources with optional type, XPath, and date filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The record's 20-character Legal Entity Identifier. |
| `date` | string | No | ISO 8601 date and time at which the modification occurred. |
| `page_size` | integer | No | Maximum field modifications in this page (1-200). |
| `field_xpath` | string | No | CDF XPath of the changed field. |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |
| `record_type` | string ("LEI" | "RR" | "REPEX") | No | Record family whose changes should be returned. |
| `modification_type` | string ("INITIAL" | "INSERT" | "DELETE" | "UPDATE") | No | Kind of field change to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List LEI ISINs

**Slug:** `GLEIF_LIST_LEI_ISINS`

Return one page of complete GLEIF-ANNA ISIN mappings for an issuer LEI.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The issuer entity's 20-character Legal Entity Identifier. |
| `page_size` | integer | No | Maximum ISIN mappings in this page (1-200). |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List LEI Issuer Jurisdictions

**Slug:** `GLEIF_LIST_LEI_ISSUER_JURISDICTIONS`

List one page of complete jurisdiction resources for which an LEI issuer is accredited.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum accredited jurisdictions in this page (1-200). |
| `issuer_lei` | string | Yes | The 20-character LEI identifying the issuer. |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reference Data

**Slug:** `GLEIF_LIST_REFERENCE_DATA`

List one complete JSON:API page from a selected GLEIF field, code, or issuer reference collection. Use GLEIF_LIST_REGISTRATION_AGENTS for the unpaginated registration-agent collection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Case-insensitive OOR name filter; only valid for official organizational roles. |
| `page_size` | integer | No | Maximum reference items in this page (1-200). |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |
| `country_code` | string | No | OOR country filter; only valid for official organizational roles. |
| `reference_type` | string ("fields" | "countries" | "entity_legal_forms" | "official_organizational_roles" | "jurisdictions" | "regions" | "registration_authorities" | "lei_issuers" | "vlei_issuers") | Yes | Closed selector for reference collections that support JSON:API pagination. Use GLEIF_LIST_REGISTRATION_AGENTS for registration agents. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Registration Agents

**Slug:** `GLEIF_LIST_REGISTRATION_AGENTS`

List all GLEIF registration agents, optionally filtered by issuer LEI or registration-agent LEI. This provider operation returns the complete collection and does not support pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei_issuer` | string | No | Return registration agents associated with this issuer LEI. |
| `registration_agent_lei` | string | No | Return the registration agent with this LEI. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Successor Entities

**Slug:** `GLEIF_LIST_SUCCESSOR_ENTITIES`

List one page of all successor LEI records for an entity. Prefer this action over the deprecated GLEIF_GET_SUCCESSOR_ENTITY lookup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lei` | string | Yes | The 20-character LEI whose successor entities should be listed. |
| `page_size` | integer | No | Maximum successor LEI records in this page (1-200). |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search LEI Records

**Slug:** `GLEIF_SEARCH_LEI_RECORDS`

Search LEI records with closed, field-aware filters and sorting, returning one complete JSON:API page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bic` | string | No | Legacy BIC mapping filter. |
| `isin` | string | No | Legacy ISIN mapping filter. |
| `sort` | string | No | Typed sort or the legacy provider sort expression. |
| `filters` | array | No | Closed field-aware filters. Each field may appear only once. |
| `owns_lei` | string | No | Return the reported parent of this child LEI. |
| `full_text` | string | No | Broad text search across indexed LEI fields. |
| `lei_codes` | array | No | Legacy exact LEI-code filter. |
| `page_size` | integer | No | Maximum records in this page (1-200). |
| `legal_name` | string | No | Legacy legal-name match filter. |
| `next_cursor` | string | No | Opaque cursor from the preceding call. Pass it back unchanged and omit it for the first page. |
| `owned_by_lei` | string | No | Return entities reported as children of this parent LEI. |
| `conformity_flag` | string ("CONFORMING" | "NON_CONFORMING" | "NOT_APPLICABLE") | No | Legacy conformity-flag filter. |
| `entity_category` | string | No | Legacy entity-category filter. |
| `registration_status` | string ("ISSUED" | "LAPSED" | "ANNULLED" | "DUPLICATE" | "RETIRED" | "PENDING_ARCHIVAL" | "PENDING_TRANSFER" | "MERGED") | No | Legacy registration-status filter. |
| `legal_address_country` | string | No | Legacy legal-address country filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |