---
title: "Look up a Legal Entity Identifier (GLEIF)"
method: GET
path: "/lei/{lei}"
tags: ["Validation"]
---

# Look up a Legal Entity Identifier (GLEIF)

`GET /lei/{lei}`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/lei/{lei}`
- Auth: HTTP bearer

Look up a 20-character ISO 17442 LEI in the GLEIF global register. Returns the legal name, jurisdiction, entity and registration status, legal/HQ address, managing LOU, and next renewal date. Use to validate or enrich a counterparty that publishes an LEI. Costs 1 credit.

## Path parameters

- `lei` string, required

## Response `200`

LEI record

- object
  - `data` LeiRecord
    - `lei` string
    - `legal_name` string, nullable
    - `legal_form_code` string, nullable: Entity Legal Form (ELF) code, ISO 20275.
    - `jurisdiction` string, nullable
    - `entity_status` string, nullable: e.g. ACTIVE, INACTIVE.
    - `entity_category` string, nullable
    - `legal_address` LeiAddress, nullable
      - `lines` string[]
      - `city` string, nullable
      - `region` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable
    - `headquarters_address` LeiAddress, nullable
      - `lines` string[]
      - `city` string, nullable
      - `region` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable
    - `registration_status` string, nullable: e.g. ISSUED, LAPSED, RETIRED.
    - `initial_registration_date` string, nullable
    - `last_update_date` string, nullable
    - `next_renewal_date` string, nullable
    - `managing_lou` string, nullable: LEI of the Local Operating Unit that manages this record.
    - `bic` string[], nullable: Linked BIC code(s), when mapped by GLEIF.
    - `source` string

## Other responses

- `400`: Missing or invalid parameters
- `401`: Missing, invalid, or expired API key
- `403`: Key lacks the required scope or country access
- `404`: Record or endpoint not found
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset
- `503`: GLEIF upstream temporarily unavailable or timed out. Retryable.

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/3ee0626d5a45?raw)