LEI Lookup
Status, jurisdiction, addresses and parent companies for a Legal Entity Identifier.
curl -X POST https://api.1lookup.dev/v1/lei-lookup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lei":"5493000EXAMPLE00LE55"}'{
"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>requiredYour 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.
leistringrequiredLEI or legal name. Example: 5493000EXAMPLE00LE55
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour 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.
successbooleantrue when the lookup ran.
data.legal_namestringThe entity's official name as registered with its LEI issuer.
data.entity_statusstringACTIVE or INACTIVE, meaning whether the legal entity itself still exists.
data.registration.statusstringThe state of the LEI registration, such as ISSUED, LAPSED or RETIRED.
data.registration.next_renewal_datestringThe date the registration must be renewed to stay current.
data.jurisdictionstringThe country or subdivision whose law the entity was formed under.
data.legal_formstringThe type of entity, for example a corporation or limited liability company.
data.headquarters_addressobjectWhere the entity is run from, returned next to its legal address.
data.parents.ultimateobjectThe top consolidating parent's LEI and name, where the entity has reported one.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote 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.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An 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