---
title: "GLEIF"
slug: "gleif"
updated: 2025-10-22T15:17:16Z
published: 2025-10-22T15:17:16Z
canonical: "support.lusid.com/gleif"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GLEIF

FINBOURNE offers a dedicated [Global Legal Entity Identifier Foundation (GLEIF)](https://www.gleif.org/en/about/this-is-gleif) data provider that allows you to access comprehensive [Legal Entity Identifier (LEI)](https://www.gleif.org/en/about-lei/introducing-the-legal-entity-identifier-lei) reference data directly within LUSID.

This integration enables you to enrich your data with entity identification and ownership structure information from GLEIF’s global directory.

> [!NOTE]
> Prerequisites
> 
> Before getting started, ensure you have:
> 
> - [x] [Contacted your FINBOURNE representative](https://www.finbourne.com/contact) to enable the integration in your LUSID domain

## Running the integration

You can use Luminesce to [build custom queries](/v1/docs/understanding-the-luminesce-sql-query-syntax) and bespoke data imports using the `Gleif.LegalEntity.MatchFilter` data provider, which you can schedule or run on demand.

> [!WARNING]
> Rate limits
> 
> GLEIF limits use to 60 requests per minute per user. If the provider hits the rate limit during a request, it will pause until the minute has elapsed and then resume. We recommend retrieving data by LEI as requests are batched into 50 LEIs per request; this reduces the likelihood of being rate limited.

### Supported `FilterField` options

`Gleif.LegalEntity.MatchFilter` has a `FilterField` parameter that accepts fields from the GLEIF API.

*****Expand to see the full list of supported values*****

You can also view the full list of supported values in section 1.1 of the [GLEIF Data Dictionary](https://www.gleif.org/en/lei-data/access-and-use-lei-data/gleif-data-dictionary#) in the **GLEIF API** column.

| `FilterField` | Description |
| --- | --- |
| `entity.addresses` | Addresses |
| `entity.addresses.city` | City |
| `entity.addresses.country` | Country |
| `entity.addresses.postalCode` | Postal Code |
| `entity.addresses.region` | Region |
| `entity.associatedEntity` | Associated Entity |
| `bic` | BICs |
| `branches.addresses.city` | Branch City |
| `branchCount` | Branch Count |
| `branches.addresses.country` | Branch Country |
| `branches.entityStatus` | Branch Entity Status |
| `branches.legalName` | Branch Legal Name |
| `branches.lei` | Branch LEI |
| `branches.managingLou` | Branch LEI Issuer |
| `branches.names` | Branch Names |
| `branches.addresses.postalCode` | Branch Postal Codes |
| `branches.addresses.region` | Branch Region |
| `branches.validFrom` | Branch Valid From |
| `branches.validTo` | Branch Valid To |
| `ultimateChildren.addresses.postalCode` | Ultimate Child Postal Codes |
| `directChildren.addresses.city` | Direct Child City |
| `directChildCount` | Direct child Count |
| `directChildren.addresses.country` | Direct Child Country |
| `directChildren.entityStatus` | Direct Child Entity Status |
| `directChildren.legalName` | Direct Child Legal Name |
| `directChildren.lei` | Direct Child LEI |
| `directChildren.managingLou` | Direct Child LEI Issuer |
| `directChildren.names` | Direct Child Names |
| `directChildren.addresses.postalCode` | Direct Child Postal Codes |
| `directChildren.addresses.region` | Direct Child Region |
| `directChildren.validFrom` | Direct Child Valid From |
| `directChildren.validTo` | Direct Child Valid To |
| `directParent.addresses.city` | Direct Parent City |
| `directParent.addresses.country` | Direct Parent Country |
| `directParent.entityStatus` | Direct Parent Entity Status |
| `directParent.exception.reason` | Direct Parent Exception Reason |
| `directParent.exception.validFrom` | Direct Parent Exception Valid From |
| `directParent.exception.validTo` | Direct Parent Exception Valid To |
| `directParent.legalName` | Direct Parent Legal Name |
| `directParent.lei` | Direct Parent LEI |
| `directParent.managingLou` | Direct Parent LEI Issuer |
| `directParent.names` | Direct Parent Names |
| `directParent.addresses.postalCode` | Direct Parent Postal Codes |
| `directParent.addresses.region` | Direct Parent Region |
| `directParent.validFrom` | Direct Parent Valid From |
| `directParent.validTo` | Direct Parent Valid To |
| `entity.category` | General Category |
| `entity.creationDate` | Entity Creation Date |
| `entity.expiration.date` | Expiration Date |
| `entity.expiration.reason` | Expiration Reason |
| `entity.legalForm.other` | Entity Legal Form (other) |
| `entity.status` | Entity Status |
| `entity.subCategory` | Sub Category |
| `feederFunds.addresses.city` | Feeder Fund City |
| `feederFundCount` | Feeder Fund Count |
| `feederFunds.addresses.country` | Feeder Fund Country |
| `feederFunds.entityStatus` | Feeder Fund Entity Status |
| `feederFunds.legalName` | Feeder Fund Legal Name |
| `feederFunds.lei` | Feeder Fund LEI |
| `feederFunds.managingLou` | Feeder Fund LEI Issuer |
| `feederFunds.names` | Feeder Fund Names |
| `feederFunds.addresses.postalCode` | Feeder Fund Postal Codes |
| `feederFunds.addresses.region` | Feeder Fund Region |
| `feederFunds.validFrom` | Feeder Fund Valid From |
| `feederFunds.validTo` | Feeder Fund Valid To |
| `fulltext` | Find LEIs |
| `fundManager.addresses.city` | Fund Manager City |
| `fundManager.addresses.country` | Fund Manager Country |
| `fundManager.entityStatus` | Fund Manager Entity Status |
| `fundManager.legalName` | Fund Manager Legal Name |
| `fundManager.lei` | Fund Manager LEI |
| `fundManager.managingLou` | Fund Manager LEI Issuer |
| `fundManager.names` | Fund Manager Names |
| `fundManager.addresses.postalCode` | Fund Manager Postal Codes |
| `fundManager.addresses.region` | Fund Manager Region |
| `fundManager.validFrom` | Fund Manager Valid From |
| `fundManager.validTo` | Fund Manager Valid To |
| `headOffice.addresses.city` | Head office City |
| `headOffice.addresses.country` | Head office Country |
| `headOffice.entityStatus` | Head office Entity Status |
| `headOffice.legalName` | Head office Legal Name |
| `headOffice.lei` | Head office LEI |
| `headOffice.managingLou` | Head office LEI Issuer |
| `headOffice.names` | Head office Names |
| `headOffice.addresses.postalCode` | Head office Postal Codes |
| `headOffice.addresses.region` | Head office Region |
| `headOffice.validFrom` | Head office Valid From |
| `headOffice.validTo` | Head office Valid To |
| `registration.initialRegistrationDate` | Registration Date |
| `isin` | ISIN Code |
| `registration.lastUpdateDate` | Last Update |
| `entity.legalAddress.country` | Legal Address Country |
| `entity.legalForm` | Entity Legal Form |
| `entity.jurisdiction` | Jurisdiction of Formation |
| `entity.legalName` | (Primary) Legal Name |
| `lei` | LEI Code |
| `managedFunds.addresses.city` | Managed Fund City |
| `managedFundCount` | Managed Fund Count |
| `managedFunds.addresses.country` | Managed Fund Country |
| `managedFunds.entityStatus` | Managed Fund Entity Status |
| `managedFunds.legalName` | Managed Fund Legal Name |
| `managedFunds.lei` | Managed Fund LEI |
| `managedFunds.managingLou` | Managed Fund LEI Issuer |
| `managedFunds.names` | Managed Fund Names |
| `managedFunds.addresses.postalCode` | Managed Fund Postal Codes |
| `managedFunds.addresses.region` | Managed Fund Region |
| `managedFunds.validFrom` | Managed Fund Valid From |
| `managedFunds.validTo` | Managed Fund Valid To |
| `registration.managingLou` | LEI Issuer |
| `masterFund.addresses.city` | Master Fund City |
| `masterFund.addresses.country` | Master Fund Country |
| `masterFund.entityStatus` | Master Fund Entity Status |
| `masterFund.legalName` | Master Fund Legal Name |
| `masterFund.lei` | Master Fund LEI |
| `masterFund.managingLou` | Master Fund LEI Issuer |
| `masterFund.names` | Master Fund Names |
| `masterFund.addresses.postalCode` | Master Fund Postal Codes |
| `masterFund.addresses.region` | Master Fund Region |
| `masterFund.validFrom` | Master Fund Valid From |
| `masterFund.validTo` | Master Fund Valid To |
| `mic` | MICs |
| `entity.names` | All Names |
| `registration.nextRenewalDate` | Next Renewal |
| `ocid` | OCID |
| `entity.otherNames` | Other Entity Name (only) |
| `entity.registeredAt.other` | Registered At (other) |
| `registration.otherValidationAuthorities.validatedAt.id` | Data Validated At (ID) |
| `registration.otherValidationAuthorities.validatedAs` | Data Validated As |
| `registration.otherValidationAuthorities.validatedAt.other` | Data Validated At (other) |
| `ownedBy` | Who is Owned By... |
| `owns` | Who Owns... |
| `conformityFlag` | Policy Conformity Flag |
| `qcc` | QCCs |
| `entity.registeredAt` | Registered At |
| `entity.registeredAs` | Registered As |
| `registration.status` | Status |
| `spglobal` | S&P Global Company ID |
| `subFunds.addresses.city` | Sub-Fund City |
| `subFundCount` | Sub-Fund Count |
| `subFunds.addresses.country` | Sub-Fund Country |
| `subFunds.entityStatus` | Sub-Fund Entity Status |
| `subFunds.legalName` | Sub-Fund Legal Name |
| `subFunds.lei` | Sub-Fund LEI |
| `subFunds.managingLou` | Sub-Fund LEI Issuer |
| `subFunds.names` | Sub-Fund Names |
| `subFunds.addresses.postalCode` | Sub-Fund Postal Codes |
| `subFunds.addresses.region` | Sub-Fund Region |
| `subFunds.validFrom` | Sub-Fund Valid From |
| `subFunds.validTo` | Sub-Fund Valid To |
| `entity.successorEntities` | Replaced By |
| `entity.successorEntities.lang` | Successor Entity Lang |
| `entity.successorEntities.lei` | Successor Entity LEI |
| `entity.successorEntities.name` | Successor Entity Name |
| `entity.transliteratedOtherNames` | Transliterated Other Entity Name (only) |
| `entity.transliteratedOtherNames.type` | Type of Transliterated Other Entity Name |
| `ultimateChildren.addresses.city` | Ultimate Child City |
| `ultimateChildCount` | Ultimate Child Count |
| `ultimateChildren.addresses.country` | Ultimate Child Country |
| `ultimateChildren.entityStatus` | Ultimate Child Entity Status |
| `ultimateChildren.legalName` | Ultimate Child Legal Name |
| `ultimateChildren.lei` | Ultimate Child LEI |
| `ultimateChildren.managingLou` | Ultimate Child LEI Issuer |
| `ultimateChildren.names` | Ultimate Child Names |
| `ultimateChildren.addresses.region` | Ultimate Child Region |
| `ultimateChildren.validFrom` | Ultimate Child Valid From |
| `ultimateChildren.validTo` | Ultimate Child Valid To |
| `ultimateParent.addresses.city` | Ultimate Parent City |
| `ultimateParent.addresses.country` | Ultimate Parent Country |
| `ultimateParent.entityStatus` | Ultimate Parent Entity Status |
| `ultimateParent.exception.reason` | Ultimate Parent Exception Reason |
| `ultimateParent.exception.validFrom` | Direct Parent Exception Valid From |
| `ultimateParent.exception.validTo` | Direct Parent Exception Valid To |
| `ultimateParent.legalName` | Ultimate Parent Legal Name |
| `ultimateParent.lei` | Ultimate Parent LEI |
| `ultimateParent.managingLou` | Ultimate Parent LEI Issuer |
| `ultimateParent.names` | Ultimate Parent Names |
| `ultimateParent.addresses.postalCode` | Ultimate Parent Postal Codes |
| `ultimateParent.addresses.region` | Ultimate Parent Region |
| `ultimateParent.validFrom` | Ultimate Parent Valid From |
| `ultimateParent.validTo` | Ultimate Parent Valid To |
| `umbrellaFund.addresses.city` | Umbrella Fund City |
| `umbrellaFund.addresses.country` | Umbrella Fund Country |
| `umbrellaFund.entityStatus` | Umbrella Fund Entity Status |
| `umbrellaFund.legalName` | Umbrella Fund Legal Name |
| `umbrellaFund.lei` | Umbrella Fund LEI |
| `umbrellaFund.managingLou` | Umbrella Fund LEI Issuer |
| `umbrellaFund.names` | Umbrella Fund Names |
| `umbrellaFund.addresses.postalCode` | Umbrella Fund Postal Codes |
| `umbrellaFund.addresses.region` | Umbrella Fund Region |
| `umbrellaFund.validFrom` | Umbrella Fund Valid From |
| `umbrellaFund.validTo` | Umbrella Fund Valid To |
| `registration.validatedAs` | Data Validated As |
| `registration.validatedAt` | Data Validated At |
| `registration.corroborationLevel` | Corroboration Level |

The `FilterField` parameter supports fuzzy matching, allowing you to search for entities using approximate values rather than requiring exact matches.

> [!NOTE]
> Note
> 
> Fuzzy matching of a data field is based on statistical similarity. It does not guarantee that the LEI belongs to the legal entity you are searching for. **Always verify your results, especially when fuzzy matching on name and address fields.**

### Example A: Retrieving entity data by LEI

```sql
@request = select 'lei' as FilterField, '851WYGNLUQLFZBSYGB56' as FilterValueMatch;

select * from Gleif.LegalEntity.MatchFilter where request = @request;
```

### Example B: Finding entities by category

```sql
@classification = values
('entity.subCategory','CENTRAL_GOVERNMENT');

@request = 
select column1 as FilterField, column2 as FilterValueMatch from @classification;

select * from Gleif.LegalEntity.MatchFilter where request = @request;
```

### Example C: Retrieving owner relationships and corporate structures

```sql
-- Define entity to retrieve data for
@request = select 'lei' as FilterField, '724500KGJLP14RSC0819' as FilterValueMatch;
@LEIs = select * from Gleif.LegalEntity.MatchFilter where request = @request;

-- Define fields to retrieve data for - in this example, these fields are parent and ultimate parent entities
@linkRequest =
select 'lei' as FilterField,
DirectParentLei as FilterValueMatch
from @LEIs 
where DirectParentLei is not null
union
select 'lei' as FilterField,
UltimateParentLei as FilterValueMatch
from @LEIs
where UltimateParentLei is not null;

-- Request the data from GLEIF
@parentLEIs =
select * from Gleif.LegalEntity.MatchFilter where request = @linkRequest;

select * from @LEIs union
select * from @parentLEIs;
```