Data format & Data model of LEI system

Think of Level 1 Data as “business card information” data that provides answers to the “Who is Who” question.

The corresponding data format: LEI-CDF version 1 (also called LEI Data File Format 1.0) has been developed and introduced by LEI ROC since August 2014. LEI-CDF is an XML file format and its structure is dictated by the XML Schema document (https://www.gleif.org/_documents/lei-data-file-format.xsd).

The documentation of the 1.0 format is available for download from the GLEIF website: (https://www.gleif.org/content/2-about-lei/6-common-data-file-format/1-lei-cdf-format/1-lei-cdf-format-version-1-0/lou-20140620.pdf)

In November 2016, GLEIF published LEI-CDF version 2.0 of the format (LEI Data File Format 2.0). The main objective of the update was to respond to the reflections of LOUs regarding the registration processes that have been aggregated since its inception, and to also overcome some of the observed difficulties with the collection of “who is who” type reference data.

Half a year later, in May 2017, GLEIF published the next update of the LEI-CDF format (LEI Data File Format 2.1), that contained a consortium of corrections (bug fixes, a new element, change of constrains, and some minor documentation changes).

Level 1 Data Model

The LEI-CDF format version 2.1 is the current and most up-to-date file format. It can be visualized in the following form:

 

 Level 1 Data Format

 

In principle, whilst the data model is already defined, it can be expressed in a range of different file formats.  The canonical file format for LEI CDF is XML and is defined in the respective XML Schema (see below).

In the following example you can see the LEI XML record in the LEI Data File Format 2.1:

<?xml version="1.0" encoding="UTF-8"?>
<LEIRecord>
	<LEI>2594007XIACKNMUAW223</LEI>
	<Entity>
		<LegalName xml:lang="PL">MAKOLAB SPÓŁKA AKCYJNA</LegalName>
		<TransliteratedOtherEntityNames>
			<TransliteratedOtherEntityName xml:lang="PL" type="PREFERRED_ASCII_TRANSLITERATED_LEGAL_NAME">MAKOLAB SPOLKA AKCYJNA</TransliteratedOtherEntityName>
		</TransliteratedOtherEntityNames>
		<LegalAddress>
			<FirstAddressLine>ŁÓDŹ DEMOKRATYCZNA 46</FirstAddressLine>
			<AddressNumber>46</AddressNumber>
			<City>ŁÓDŹ</City>
			<Region>PL-LD</Region>
			<Country>PL</Country>
			<PostalCode>93-430</PostalCode>
		</LegalAddress>
		<HeadquartersAddress>
			<FirstAddressLine>ŁÓDŹ DEMOKRATYCZNA 46</FirstAddressLine>
			<AddressNumber>46</AddressNumber>
			<City>ŁÓDŹ</City>
			<Region>PL-LD</Region>
			<Country>PL</Country>
			<PostalCode>93-430</PostalCode>
		</HeadquartersAddress>
		<RegistrationAuthority>
			<RegistrationAuthorityID>RA000484</RegistrationAuthorityID>
			<RegistrationAuthorityEntityID>0000289179</RegistrationAuthorityEntityID>
		</RegistrationAuthority>
		<LegalJurisdiction>PL-LD</LegalJurisdiction>
		<LegalForm>
			<EntityLegalFormCode>8888</EntityLegalFormCode>
			<OtherLegalForm>Spółka akcyjna</OtherLegalForm>
		</LegalForm>
		<EntityStatus>ACTIVE</EntityStatus>
	</Entity>
	<Registration>
		<InitialRegistrationDate>2015-01-22T18:20:38+01:00</InitialRegistrationDate>
		<LastUpdateDate>2016-12-19T18:14:14+01:00</LastUpdateDate>
		<RegistrationStatus>ISSUED</RegistrationStatus>
		<NextRenewalDate>2018-01-21T18:20:37+01:00</NextRenewalDate>
		<ManagingLOU>259400L3KBYEVNHEJF55</ManagingLOU>
		<ValidationSources>FULLY_CORROBORATED</ValidationSources>
		<ValidationAuthority>
			<ValidationAuthorityID>RA000484</ValidationAuthorityID>
			<ValidationAuthorityEntityID>0000289179</ValidationAuthorityEntityID>
		</ValidationAuthority>
	</Registration>
</LEIRecord>

Level 1 Data Model can also be expressed in JSON format:

[
   {
      "lei:LEIRecord": {
         "@xmlns:lei": "http://www.gleif.org/data/schema/leidata/2016",
         "@xmlns:xml": "http://www.w3.org/XML/1998/namespace",
         "@xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
         "lei:LEI": "2594007XIACKNMUAW223",
         "lei:Entity": {
            "lei:LegalName": {
               "@xml:lang": "PL",
               "$": "MAKOLAB SPÓŁKA AKCYJNA"
            },
            "lei:TransliteratedOtherEntityNames": {
               "lei:TransliteratedOtherEntityName": {
                  "@xml:lang": "PL",
                  "@type": "PREFERRED_ASCII_TRANSLITERATED_LEGAL_NAME",
                  "$": "MAKOLAB SPOLKA AKCYJNA"
               }
            },
            "lei:LegalAddress": {
               "lei:FirstAddressLine": "ŁÓDŹ DEMOKRATYCZNA 46",
               "lei:AddressNumber": "46",
               "lei:City": "ŁÓDŹ",
               "lei:Region": "PL-LD",
               "lei:Country": "PL",
               "lei:PostalCode": "93-430"
            },
            "lei:HeadquartersAddress": {
               "lei:FirstAddressLine": "ŁÓDŹ DEMOKRATYCZNA 46",
               "lei:AddressNumber": "46",
               "lei:City": "ŁÓDŹ",
               "lei:Region": "PL-LD",
               "lei:Country": "PL",
               "lei:PostalCode": "93-430"
            },
            "lei:RegistrationAuthority": {
               "lei:RegistrationAuthorityID": "RA000484",
               "lei:RegistrationAuthorityEntityID": "0000289179"
            },
            "lei:LegalJurisdiction": "PL-LD",
            "lei:LegalForm": {
               "lei:EntityLegalFormCode": "8888",
               "lei:OtherLegalForm": "Spółka akcyjna"
            },
            "lei:EntityStatus": "ACTIVE"
         },
         "lei:Registration": {
            "lei:InitialRegistrationDate": "2015-01-22T18:20:38+01:00",
            "lei:LastUpdateDate": "2016-12-19T18:14:14+01:00",
            "lei:RegistrationStatus": "ISSUED",
            "lei:NextRenewalDate": "2018-01-21T18:20:37+01:00",
            "lei:ManagingLOU": "259400L3KBYEVNHEJF55",
            "lei:ValidationSources": "FULLY_CORROBORATED",
            "lei:ValidationAuthority": {
               "lei:ValidationAuthorityID": "RA000484",
               "lei:ValidationAuthorityEntityID": "0000289179"
            }
         }
      }
   }
]

The XML Schema document for the LEI Data File Format 2.1 is available here. The documentation of Format 2.1 is available here.

The LEI records are available for download as concatenated files from the GLEIF website: https://www.gleif.org/en/lei-data/gleif-concatenated-file/download-the-concatenated-file