Skip to main content

API for Legal Entity Identifiers

The LEILex API allows for direct lookups to the GLEIF database. It can be used to enable client onboarding, compliance, and Know-Your-Customer (KYC) requirements.

GET LEI Details

Retrieve the complete details for a LEI record from the LEILEX database

                        Get
                        https://api.leilex.com/API/LEI/48510000JZ17NWGUA510
                        
                        {
  "total_record_count": 1,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 1,
  "has_more": false,
  "records": [
    {
      "LEI": "48510000JZ17NWGUA510",
      "LegalJurisdiction": "SI",
      "LegalForm": "delniška družba",
      "AssociatedEntityType": "",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "21/01/2016 10:09:33 +00:00",
      "LastUpdateDate": "16/01/2017 00:00:00 +00:00",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "21/01/2018 00:00:00 +00:00",
      "ManagingLOU": "48510000JZ17NWGUA510",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "5893194000",
      "BusinessRegisterCode": "AJPES",
      "AssociatedLEI": "",
      "LegalName": "KDD - Centralna klirinško depotna družba delniška družba",
      "Addresses": [
        {
          "Line1": "Tivolska cesta 48",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Ljubljana",
          "Region": "",
          "Country": "SI",
          "PostalCode": "1000",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        },
        {
          "Line1": "Tivolska cesta 48",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Ljubljana",
          "Region": "",
          "Country": "SI",
          "PostalCode": "1000",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        }
      ]
    }
  ]
}
None

GET LEI LIST

                        Get
                        https://api.leilex.com/API/LEI/?country=NO,MX&registrationStatus=PENDING&initialRegDateEnd=05-01-2017&nextRenewalDateEnd=05-01-2018

The above example will filter LEI records that have a juristriction in Norway(NO) and Mexico(MX), where the registration status is PENDING and the entity status is ACTIVE

Each filter can take multiple values separated by a comma (,). incorrect or unknown values will be ignored.

{
  "total_record_count": 604,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 7,
  "has_more": true,
  "records": [
    {
      "LEI": "5967007LIEEXZX9EJS29",
      "LegalJurisdiction": "NO",
      "LegalForm": "Aksjeselskap",
      "AssociatedEntityType": "UNKNOWN",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "UNKNOWN",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "19/03/2015 06:58:15",
      "LastUpdateDate": "19/03/2016 14:04:17",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "19/03/2017 06:58:15",
      "ManagingLOU": "5967007LIEEXZX4LPK21",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "913571282",
      "BusinessRegisterCode": "Foretaksregisteret",
      "AssociatedLEI": "",
      "LegalName": "2016 GAS INVEST AS",
      "Addresses": [
        {
          "Line1": "Øvre Slottsgate 2B",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "OSLO",
          "Region": "",
          "Country": "NO",
          "PostalCode": "0157",
          "OtherType": "",
          "AddressType": "LEGAL_ADDRESS"
        },
        {
          "Line1": "Øvre Slottsgate 2B",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "OSLO",
          "Region": "",
          "Country": "NO",
          "PostalCode": "0157",
          "OtherType": "",
          "AddressType": "HEADQUARTERS_ADDRESS"
        },
        {
          "Line1": "Øvre Slottsgate 2B",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "OSLO",
          "Region": "",
          "Country": "NO",
          "PostalCode": "0157",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        },
        {
          "Line1": "Øvre Slottsgate 2B",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "OSLO",
          "Region": "",
          "Country": "NO",
          "PostalCode": "0157",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        }
      ]
    },
    {
      "LEI": "5967007LIEEXZX79E080",
      "LegalJurisdiction": "NO",
      "LegalForm": "Sparebank",
      .......................
      .......................
take number of records to return per request, maximum value: 100, default value: 100
page specific page of records to return, default value: 1
country Filter by country legal juristriction, accepts 2 character ISO 3166-1 country code. Multiple codes can be added by separating them with a comma(,)
registrationStatus Filter by company registration status. Accepted values:
- ANNULLED
- CANCELLED
- DUPLICATE
- ISSUED
- LAPSED
- MERGED
- PENDING_ARCHIVAL
- PENDING_TRANSFER
- PENDING_VALIDATION
- RETIRED
- TRANSFERRED
Multiple codes can be added by separating them with a comma(,)
validationSources Filter by company validation status. Accepted values:
- PENDING
- ENTITY_SUPPLIED_ONLY
- PARTIALLY_CORROBORATED
- FULLY_CORROBORATED
Multiple codes can be added by separating them with a comma(,)
entityStatus Filter by company entity status. Accepted values:
- ACTIVE
- INACTIVE
Multiple codes can be added by separating them with a comma(,)
LOU Filter by a companies Local Operating Unit, accepts LOU LEI values. Multiple LOU LEI's can be added by separating them with a comma(,)
InitialRegDateStart Return records with Initial Reistration Dates later than this
(Format: DD-MM-YYYY)
InitialRegDateEnd Return records with Initial Reistration Dates earlier than this
NextRenewalDateStart Return records with Next Renewal Dates later than this
NextRenewalDateEnd Return records with Next Renewal Dates earlier than this

LEI AUTOCOMPLETE

Filter LEI records by sending partially completed characters to return a list of LEI identifiers and legal names

                        Get
                        https://api.leilex.com/API/LEI/AutoComplete/?query=CleanTech&filterType=Name
[
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Vilseck KG",
    "LEI": "39120001CK4NXMUXLH16"
  },
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Vilseck KG",
    "LEI": "39120001CK4NXMUXLH82"
  },
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Richelbach KG",
    "LEI": "39120001I4DLSGVIED33"
  },
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Richelbach KG",
    "LEI": "39120001I4DLSGVIED65"
  },
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Bockelwitz KG",
    "LEI": "39120001IO1IEBNJB640"
  },
  {
    "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Bockelwitz KG",
    "LEI": "39120001IO1IEBNJB658"
  },
  {
    "LegalName": "CHORUS CleanTech PP Life GmbH & Co. 8. KG",
    "LEI": "39120001P89AEAGP4C95"
  }
]
query Text to compare with company names or lei numbers
filterType Filter query result set by the company name or the lei number Accepted values:
- Name
- LEI
country Filter by country legal juristriction, accepts 2 character ISO 3166-1 country code. Multiple codes can be added by separating them with a comma(,)
registrationStatus Filter by company registration status. Accepted values:
- ANNULLED
- CANCELLED
- DUPLICATE
- ISSUED
- LAPSED
- MERGED
- PENDING_ARCHIVAL
- PENDING_TRANSFER
- PENDING_VALIDATION
- RETIRED
- TRANSFERRED
Multiple codes can be added by separating them with a comma(,)
validationSources Filter by company validation status. Accepted values:
- PENDING
- ENTITY_SUPPLIED_ONLY
- PARTIALLY_CORROBORATED
- FULLY_CORROBORATED
Multiple codes can be added by separating them with a comma(,)
entityStatus Filter by company entity status. Accepted values:
- ACTIVE
- INACTIVE
Multiple codes can be added by separating them with a comma(,)
LOU Filter by a companies Local Operating Unit, accepts LOU LEI values. Multiple LOU LEI's can be added by separating them with a comma(,)
initialRegDateStart Return records with Initial Reistration Dates later than this
(Format: DD-MM-YYYY)
initialRegDateEnd Return records with Initial Reistration Dates earlier than this
nextRenewalDateStart Return records with Next Renewal Dates later than this
nextRenewalDateEnd Return records with Next Renewal Dates earlier than this

LEI COMPOSITE

Get a list of LEI records by passing an array of specific LEI identifiers

                        Get
                        https://api.leilex.com/API/LEI/COMPOSITE/?leis=39120001CK4NXMUXLH82,39120001I4DLSGVIED33
{
  "total_record_count": 2,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 1,
  "has_more": false,
  "records": [
    {
      "LEI": "39120001CK4NXMUXLH82",
      "LegalJurisdiction": "DE",
      "LegalForm": "Kommanditgesellschaft",
      "AssociatedEntityType": "",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "",
      "SuccessorEntity": "39120001CK4NXMUXLH16",
      "InitialRegistrationDate": "21/01/2014 15:28:45",
      "LastUpdateDate": "14/02/2014 15:58:35",
      "RegistrationStatus": "ANNULLED",
      "NextRenewalDate": "21/01/2015 15:28:45",
      "ManagingLOU": "39120001KULK7200U106",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "HRA 97903",
      "BusinessRegisterCode": "München",
      "AssociatedLEI": "",
      "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Vilseck KG",
      "Addresses": [
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "LEGAL_ADDRESS"
        },
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "HEADQUARTERS_ADDRESS"
        }
      ]
    },
    {
      "LEI": "39120001I4DLSGVIED33",
      "LegalJurisdiction": "DE",
      "LegalForm": "Kommanditgesellschaft",
      "AssociatedEntityType": "UNKNOWN",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "UNKNOWN",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "14/02/2014 14:49:16",
      "LastUpdateDate": "14/02/2017 15:03:04",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "14/02/2018 14:49:16",
      "ManagingLOU": "39120001KULK7200U106",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "HRA 97906",
      "BusinessRegisterCode": "München",
      "AssociatedLEI": "",
      "LegalName": "CHORUS CleanTech GmbH & Co. Solarpark Richelbach KG",
      "Addresses": [
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "LEGAL_ADDRESS"
        },
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "HEADQUARTERS_ADDRESS"
        },
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        },
        {
          "Line1": "Prof.-Messerschmitt-Straße 3",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Neubiberg",
          "Region": "DE-BY",
          "Country": "DE",
          "PostalCode": "85579",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        }
      ]
    }
  ]
}
leis List of LEI identifiers separated by a comma (,)

GET LEI Local Operating Unit

Get the LEI local operating unit details, by passing the companies LEI identifier.

                        Get
                        https://api.leilex.com/API/LEI/39120001I4DLSGVIED33/LOU/
{
  "total_record_count": 1,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 1,
  "has_more": false,
  "records": [
    {
      "LEI": "39120001KULK7200U106",
      "LegalJurisdiction": "DE",
      "LegalForm": "Gesellschaft mit beschränkter Haftung",
      "AssociatedEntityType": "",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "28/05/2014 10:05:42 +00:00",
      "LastUpdateDate": "30/05/2016 12:48:39 +00:00",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "28/05/2017 10:05:42 +00:00",
      "ManagingLOU": "39120001KULK7200U106",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "HRB 31248",
      "BusinessRegisterCode": "Köln",
      "AssociatedLEI": "",
      "LegalName": "Bundesanzeiger Verlag GmbH",
      "Addresses": [
        {
          "Line1": "Amsterdamer Straße 192",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Köln",
          "Region": "DE-NW",
          "Country": "DE",
          "PostalCode": "50735",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        },
        {
          "Line1": "Amsterdamer Straße 192",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Köln",
          "Region": "DE-NW",
          "Country": "DE",
          "PostalCode": "50735",
          "OtherType": "",
          "AddressType": "UNKNOWN"
        }
      ]
    }
  ]
}
None

GET NEW Records

Get all LEI records registered in the last 30 days.

                        Get
                        https://api.leilex.com/API/LEI/New?Days=15
{
  "total_record_count": 3527,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 36,
  "has_more": true,
  "records": [
    {
      "LEI": "529900ZQVEQ4LJ3F4L89",
      "LegalJurisdiction": "DE",
      "LegalForm": "Gesellschaft mit beschränkter Haftung",
      "AssociatedEntityType": "",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "26/05/2017 15:01:18 +00:00",
      "LastUpdateDate": "26/05/2017 15:01:19 +00:00",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "26/05/2018 15:01:18 +00:00",
      "ManagingLOU": "5299000J2N45DDNE4Y28",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "HRB 16454",
      "BusinessRegisterCode": "RA000301",
      "AssociatedLEI": "",
      "LegalName": "#Do your sports GmbH",
      "Addresses": [
        {
          "Line1": "Nobelstraße 12",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Mönchengladbach",
          "Region": "DE-NW",
          "Country": "DE",
          "PostalCode": "41189",
          "OtherType": "",
          "AddressType": "LEGAL_ADDRESS"
        },
        {
          "Line1": "Nobelstraße 12",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Mönchengladbach",
          "Region": "DE-NW",
          "Country": "DE",
          "PostalCode": "41189",
          "OtherType": "",
          "AddressType": "HEADQUARTERS_ADDRESS"
        }
      ],
      "OtherNames": [
        {
          "Name": "(hash)Do your sports GmbH",
          "LanguageType": "",
          "NameType": "AUTO_ASCII_TRANSLITERATED_LEGAL"
        }
      ]
    },
    {
      "LEI": "254900R5K9LN58ACYE43",
      "LegalJurisdiction": "US-OH",
      "LegalForm": "LLC",
      "AssociatedEntityType": ""
       ..........................
       ..........................
Days Number of days to retrieve the records from. (Default = 30)

GET RENEWALS

Get all LEI records due for renewal in the next 30 days.

                        Get
                        https://api.leilex.com/API/LEI/Renewals/?Days=15
{
  "total_record_count": 6459,
  "page_number": 1,
  "page_size": 100,
  "total_pages": 65,
  "has_more": true,
  "records": [
    {
      "LEI": "52990019FDWFG9PTX128",
      "LegalJurisdiction": "RO",
      "LegalForm": "Societate cu Responsabilitate Limitata",
      "AssociatedEntityType": "",
      "EntityStatus": "ACTIVE",
      "EntityExpirationDate": null,
      "EntityExpirationReason": "",
      "SuccessorEntity": "",
      "InitialRegistrationDate": "25/07/2014 12:43:07 +00:00",
      "LastUpdateDate": "15/05/2017 09:38:08 +00:00",
      "RegistrationStatus": "ISSUED",
      "NextRenewalDate": "01/06/2017 00:00:00 +00:00",
      "ManagingLOU": "5299000J2N45DDNE4Y28",
      "ValidationSources": "FULLY_CORROBORATED",
      "BusinessRegisterEntityID": "J14/171/2003",
      "BusinessRegisterCode": "RA000497",
      "AssociatedLEI": "",
      "LegalName": "“HOPE SPED” SRL",
      "Addresses": [
        {
          "Line1": "ŢIGARETEI, Nr. 57",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Sfântu Gheorghe",
          "Region": "RO-CV",
          "Country": "RO",
          "PostalCode": "520033",
          "OtherType": "",
          "AddressType": "LEGAL_ADDRESS"
        },
        {
          "Line1": "ŢIGARETEI, Nr. 57",
          "Line2": "",
          "Line3": "",
          "Line4": "",
          "City": "Sfântu Gheorghe",
          "Region": "RO-CV",
          "Country": "RO",
          "PostalCode": "520033",
          "OtherType": "",
          "AddressType": "HEADQUARTERS_ADDRESS"
        }
      ],
      "OtherNames": [
        {
          "Name": "HOPE SPED SRL",
          "LanguageType": "",
          "NameType": "AUTO_ASCII_TRANSLITERATED_LEGAL"
        }
      ]
    },
    {
      "LEI": "549300EZAU6Z272SED05",
      "LegalJurisdiction": "US",
      "LegalForm": "LIMITED LIABILITY COMPANY",
       ..........................
       ..........................
Days Number of days to retrieve the records from. (Default = 30)

LEILEX Response Codes

Below is a list of response codes that the API will send back to the request getting processed.

200 - OK Everything worked as expected.
400 - Bad Request The request was unacceptable, often due to missing a required or optional parameter.
401 - Unauthorized No valid API key provided.
404 - Not Found The requested resource doesn't exist, it is suggested that you validate that the request was formatted correctly
409 - Conflict The request conflicts with another request. Please wait a few moments and try again.
429 - Too Many Requests Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500, 502, 503, 504 - Server Errors There has been an issue on the API side, please report such issues