---
title: "Get LEI mappings"
method: POST
path: "/lei-mappings"
tags: ["LEI Mappings"]
---

# Get LEI mappings

`POST /lei-mappings`

Retrieve paginated ISIN-to-LEI mappings grouped by LEI.

## Request body

- object
  - `isin` string[] — Filter by one or more ISINs.
  - `asset_id` string[] — Filter by one or more Elbstream asset IDs.
  - `lei` string[] — Filter by one or more LEIs.
  - `status` 'active' | 'inactive' | 'all' — Mapping status to return.
  - `include_related_assets` boolean — When filtering by ISIN or asset_id, include all other assets mapped to the matched LEI(s).
  - `limit` integer — Maximum number of asset mappings to return.
  - `cursor` string, uuid — Cursor from the previous page. Omit to start from the beginning.

## Response `200`

Successfully retrieved LEI mappings

- object
  - `data` object[], required — Array of LEI groups with their mapped assets
    - `lei` string, required — 20-character Legal Entity Identifier
    - `status` 'active' | 'inactive' | 'mixed', required — Status derived from the returned mappings for this LEI
    - `last_seen_at` string, date-time, required — Latest observation timestamp across the returned mappings for this LEI
    - `deactivated_at` string, date-time, nullable, required — Latest deactivation timestamp across the returned mappings for this LEI, if any
    - `assets` object[], required — Assets mapped to this LEI
      - `id` string, uuid, required — Unique identifier for the asset
      - `type` string, required — Type of the asset
      - `identifier` string, required — ISIN or other primary asset identifier
      - `name` string, required — Display name of the asset
  - `pagination` object, required — Pagination information
    - `limit` integer, required — Maximum number of asset mappings per page
    - `has_more` boolean, required — Whether there are more results available
    - `next_cursor` string, uuid, nullable, required — Cursor for fetching the next page.

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized - Missing or invalid API key
- `415` — Unsupported Media Type - Content-Type must be application/json

---

[API](https://skmtc.dev/elbstream/apis/elbstream-api.md) · [All operations](https://skmtc.dev/elbstream/apis/elbstream-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elbstream/elbstream-api/revisions/21aaa5c851aa/schema)