API Reference

LEILEX API is a RESTful based API. Communication is made through normal HTTP requests. Requests are made as strings using the HTTP GET method. All outputs are provided as a JSON formatted response. We support cross-origin resource sharing

There is currently no authentication required to access any functions on the LEILEX API.

Skip to Area:

GET LEI Details

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

GET: https://api.leilex.com/API/LEI/{lei_identifier}

Example Request 
https://api.leilex.com/API/LEI/48510000JZ17NWGUA510

Example Response 
{
  "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"
        }
      ]
    }
  ]
}
show all code
Optional Parameters 
None

GET LEI LIST

Retrieve a list of LEI records by filtering different criteria against known fields

GET: https://api.leilex.com/API/LEI/{filter(s)}

Example Request 
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.


Example Response 
{
  "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",
      .......................
      .......................
show all code
Optional Parameters
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={legal_name}&filterType={search_type}

Example Request 
https://api.leilex.com/API/LEI/AutoComplete/?query=CleanTech&filterType=Name

Example Response 
[
  {
    "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"
  }
]
show all code
Optional Parameters
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={lei_list_comma_separated}

Example Request 
https://api.leilex.com/API/LEI/COMPOSITE/?leis=39120001CK4NXMUXLH82,39120001I4DLSGVIED33

Example Response 
{
  "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"
        }
      ]
    }
  ]
}
show all code
Optional Parameters
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/{lei_identifier}/LOU/

Example Request 
https://api.leilex.com/API/LEI/39120001I4DLSGVIED33/LOU/

Example Response 
{
  "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"
        }
      ]
    }
  ]
}
show all code
Optional Parameters 
None

GET NEW Records

Get all LEI records registered in the last 30 days.

GET: https://api.leilex.com/API/LEI/New

Example Request 
https://api.leilex.com/API/LEI/New?Days=15

Example Response 
{
  "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": ""
       ..........................
       ..........................
show all code
Optional Parameters
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

Example Request 
https://api.leilex.com/API/LEI/Renewals/?Days=15

Example Response 
{
  "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",
       ..........................
       ..........................
show all code
Optional Parameters
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