---
title: "Search the GLEIF LEI register by name"
method: GET
path: "/lei/search"
tags: ["Validation"]
---

# Search the GLEIF LEI register by name

`GET /lei/search`

## Request

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

Full-text search the GLEIF global LEI register by legal-entity name. Returns candidate LEIs with legal name, jurisdiction, status, and city/country — use to resolve a company name to its LEI before /lei/{lei}. Costs 1 credit.

## Query parameters

- `name` string, required
- `limit` integer

## Response `200`

Candidate LEI records

- object
  - `data` LeiSearchResult[]
    - `lei` string, nullable
    - `legal_name` string, nullable
    - `jurisdiction` string, nullable
    - `entity_status` string, nullable
    - `city` string, nullable
    - `country` string, nullable

## Other responses

- `400`: Missing or invalid parameters
- `401`: Missing, invalid, or expired API key
- `403`: Key lacks the required scope or country access
- `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/b01703443e4e?raw)