FINBOURNE offers a dedicated Global Legal Entity Identifier Foundation (GLEIF) data provider that allows you to access comprehensive 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.
Prerequisites
Before getting started, ensure you have:
Contacted your FINBOURNE representative to enable the integration in your LUSID domain
Running the integration
You can use Luminesce to build custom queries and bespoke data imports using the Gleif.LegalEntity.MatchFilter data provider, which you can schedule or run on demand.
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 in the GLEIF API column.
| Description |
|---|---|
| Addresses |
| City |
| Country |
| Postal Code |
| Region |
| Associated Entity |
| BICs |
| Branch City |
| Branch Count |
| Branch Country |
| Branch Entity Status |
| Branch Legal Name |
| Branch LEI |
| Branch LEI Issuer |
| Branch Names |
| Branch Postal Codes |
| Branch Region |
| Branch Valid From |
| Branch Valid To |
| Ultimate Child Postal Codes |
| Direct Child City |
| Direct child Count |
| Direct Child Country |
| Direct Child Entity Status |
| Direct Child Legal Name |
| Direct Child LEI |
| Direct Child LEI Issuer |
| Direct Child Names |
| Direct Child Postal Codes |
| Direct Child Region |
| Direct Child Valid From |
| Direct Child Valid To |
| Direct Parent City |
| Direct Parent Country |
| Direct Parent Entity Status |
| Direct Parent Exception Reason |
| Direct Parent Exception Valid From |
| Direct Parent Exception Valid To |
| Direct Parent Legal Name |
| Direct Parent LEI |
| Direct Parent LEI Issuer |
| Direct Parent Names |
| Direct Parent Postal Codes |
| Direct Parent Region |
| Direct Parent Valid From |
| Direct Parent Valid To |
| General Category |
| Entity Creation Date |
| Expiration Date |
| Expiration Reason |
| Entity Legal Form (other) |
| Entity Status |
| Sub Category |
| Feeder Fund City |
| Feeder Fund Count |
| Feeder Fund Country |
| Feeder Fund Entity Status |
| Feeder Fund Legal Name |
| Feeder Fund LEI |
| Feeder Fund LEI Issuer |
| Feeder Fund Names |
| Feeder Fund Postal Codes |
| Feeder Fund Region |
| Feeder Fund Valid From |
| Feeder Fund Valid To |
| Find LEIs |
| Fund Manager City |
| Fund Manager Country |
| Fund Manager Entity Status |
| Fund Manager Legal Name |
| Fund Manager LEI |
| Fund Manager LEI Issuer |
| Fund Manager Names |
| Fund Manager Postal Codes |
| Fund Manager Region |
| Fund Manager Valid From |
| Fund Manager Valid To |
| Head office City |
| Head office Country |
| Head office Entity Status |
| Head office Legal Name |
| Head office LEI |
| Head office LEI Issuer |
| Head office Names |
| Head office Postal Codes |
| Head office Region |
| Head office Valid From |
| Head office Valid To |
| Registration Date |
| ISIN Code |
| Last Update |
| Legal Address Country |
| Entity Legal Form |
| Jurisdiction of Formation |
| (Primary) Legal Name |
| LEI Code |
| Managed Fund City |
| Managed Fund Count |
| Managed Fund Country |
| Managed Fund Entity Status |
| Managed Fund Legal Name |
| Managed Fund LEI |
| Managed Fund LEI Issuer |
| Managed Fund Names |
| Managed Fund Postal Codes |
| Managed Fund Region |
| Managed Fund Valid From |
| Managed Fund Valid To |
| LEI Issuer |
| Master Fund City |
| Master Fund Country |
| Master Fund Entity Status |
| Master Fund Legal Name |
| Master Fund LEI |
| Master Fund LEI Issuer |
| Master Fund Names |
| Master Fund Postal Codes |
| Master Fund Region |
| Master Fund Valid From |
| Master Fund Valid To |
| MICs |
| All Names |
| Next Renewal |
| OCID |
| Other Entity Name (only) |
| Registered At (other) |
| Data Validated At (ID) |
| Data Validated As |
| Data Validated At (other) |
| Who is Owned By... |
| Who Owns... |
| Policy Conformity Flag |
| QCCs |
| Registered At |
| Registered As |
| Status |
| S&P Global Company ID |
| Sub-Fund City |
| Sub-Fund Count |
| Sub-Fund Country |
| Sub-Fund Entity Status |
| Sub-Fund Legal Name |
| Sub-Fund LEI |
| Sub-Fund LEI Issuer |
| Sub-Fund Names |
| Sub-Fund Postal Codes |
| Sub-Fund Region |
| Sub-Fund Valid From |
| Sub-Fund Valid To |
| Replaced By |
| Successor Entity Lang |
| Successor Entity LEI |
| Successor Entity Name |
| Transliterated Other Entity Name (only) |
| Type of Transliterated Other Entity Name |
| Ultimate Child City |
| Ultimate Child Count |
| Ultimate Child Country |
| Ultimate Child Entity Status |
| Ultimate Child Legal Name |
| Ultimate Child LEI |
| Ultimate Child LEI Issuer |
| Ultimate Child Names |
| Ultimate Child Region |
| Ultimate Child Valid From |
| Ultimate Child Valid To |
| Ultimate Parent City |
| Ultimate Parent Country |
| Ultimate Parent Entity Status |
| Ultimate Parent Exception Reason |
| Direct Parent Exception Valid From |
| Direct Parent Exception Valid To |
| Ultimate Parent Legal Name |
| Ultimate Parent LEI |
| Ultimate Parent LEI Issuer |
| Ultimate Parent Names |
| Ultimate Parent Postal Codes |
| Ultimate Parent Region |
| Ultimate Parent Valid From |
| Ultimate Parent Valid To |
| Umbrella Fund City |
| Umbrella Fund Country |
| Umbrella Fund Entity Status |
| Umbrella Fund Legal Name |
| Umbrella Fund LEI |
| Umbrella Fund LEI Issuer |
| Umbrella Fund Names |
| Umbrella Fund Postal Codes |
| Umbrella Fund Region |
| Umbrella Fund Valid From |
| Umbrella Fund Valid To |
| Data Validated As |
| Data Validated At |
| Corroboration Level |
The FilterField parameter supports fuzzy matching, allowing you to search for entities using approximate values rather than requiring exact matches.
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
@request = select 'lei' as FilterField, '851WYGNLUQLFZBSYGB56' as FilterValueMatch;
select * from Gleif.LegalEntity.MatchFilter where request = @request;Example B: Finding entities by category
@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
-- 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;