Skip to content
Compliance & Registries

LEI Lookup

Status, jurisdiction, addresses and parent companies for a Legal Entity Identifier.

POST/v1/lei-lookup
2 creditsBulk supportedGlobal
Request
curl -X POST https://api.1lookup.dev/v1/lei-lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lei":"5493000EXAMPLE00LE55"}'
Response
{
  "success": true,
  "data": {
    "lei": "5493000EXAMPLE00LE55",
    "legal_name": "Northwind Logistics Inc",
    "entity_status": "ACTIVE",
    "jurisdiction": "US-DE",
    "legal_form": "Corporation",
    "registration": {
      "status": "ISSUED",
      "initial_registration_date": "2018-05-21",
      "last_update_date": "2026-04-30",
      "next_renewal_date": "2027-05-21"
    },
    "legal_address": {
      "line1": "100 Example Corporate Way",
      "city": "Wilmington",
      "region": "US-DE",
      "country": "US",
      "postal_code": "19801"
    },
    "headquarters_address": {
      "line1": "1200 Example Ave",
      "city": "Austin",
      "region": "US-TX",
      "country": "US",
      "postal_code": "78701"
    },
    "parents": {
      "direct": {
        "lei": "5493000EXAMPLE00PA34",
        "legal_name": "Northwind Holdings Inc"
      },
      "ultimate": {
        "lei": "5493000EXAMPLE00UP56",
        "legal_name": "Northwind Group plc"
      }
    }
  },
  "meta": {
    "credits_used": 2,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

leistringrequired

LEI or legal name. Example: 5493000EXAMPLE00LE55

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.legal_namestring

The entity's official name as registered with its LEI issuer.

data.entity_statusstring

ACTIVE or INACTIVE, meaning whether the legal entity itself still exists.

data.registration.statusstring

The state of the LEI registration, such as ISSUED, LAPSED or RETIRED.

data.registration.next_renewal_datestring

The date the registration must be renewed to stay current.

data.jurisdictionstring

The country or subdivision whose law the entity was formed under.

data.legal_formstring

The type of entity, for example a corporation or limited liability company.

data.headquarters_addressobject

Where the entity is run from, returned next to its legal address.

data.parents.ultimateobject

The top consolidating parent's LEI and name, where the entity has reported one.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

2 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.

Product overview and use cases