---
title: "List legal entities (Paginated)"
method: GET
path: "/legal_entities"
tags: ["Compliance"]
---

# List legal entities (Paginated)

`GET /legal_entities`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/legal_entities`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/legal_entities/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns legal entity registrations for the workspace with cursor-based pagination.
If query parameter vaultAccountId is used it returns the legal entity registration associated with a specific vault account. If no explicit mapping exists for the vault, the workspace default legal entity is returned. Returns an empty response if neither a vault mapping nor a default legal entity is configured.
Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

## Query parameters

- `vaultAccountId` string, numeric
- `pageCursor` string
- `pageSize` integer

## Response `200`

A paginated list of legal entity registrations. When `vaultAccountId` is provided, `data` contains at most one item.

- ListLegalEntitiesResponse: Paginated response containing a list of legal entity registrations
  - `total` integer: Total number of legal entity registrations (optional)
  - `data` LegalEntityRegistration[], required: Legal entity registrations for the current page
    - `id` string, uuid, required: Unique registration identifier
    - `lei` string, required: Legal Entity Identifier (LEI) code
    - `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'REVOKED', required: Approval status of a legal entity registration
    - `isDefault` boolean, required: Whether this is the default legal entity for the workspace
    - `travelRuleProviders` TravelRuleProvider[], required: Travel rule providers configured for this registration
    - `travelRuleContactEmail` string, email: Contact email for travel rule communications
    - `gleifData` GleifData: GLEIF (Global Legal Entity Identifier Foundation) data for a legal entity
      - `lei` string, required: Legal Entity Identifier (LEI) code
      - `legalName` string, required: Official legal name of the entity
      - `legalNameLanguage` string: Two-letter ISO 639-1 language code
      - `otherNames` GleifOtherLegalEntityName[]: Alternative names for the entity
        - `name` string, required: Alternative name of the legal entity
        - `language` string, required: Two-letter ISO 639-1 language code
      - `legalAddressRegion` string: Region or state of the legal address
      - `legalAddressCountry` string, required: Country code of the legal address (ISO 3166-1 alpha-2)
      - `nextRenewalDate` string, date-time: Date when the LEI registration must be renewed
    - `createdAt` string, required: Creation timestamp in milliseconds since epoch
    - `updatedAt` string, required: Last update timestamp in milliseconds since epoch
  - `next` string: Cursor to pass as `pageCursor` to retrieve the next page

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)