List legal entities (Paginated)

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. </br>Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

GET /legal_entities

TypeScript

TypeScript

const response: Promise<FireblocksResponse<ListLegalEntitiesResponse>> = fireblocks.compliance.listLegalEntities(complianceApiListLegalEntitiesRequest);

200

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "lei": "529900HNOAA1KXQJUQ27",
      "status": "PENDING",
      "isDefault": false,
      "travelRuleProviders": [
        "MY_OWN"
      ],
      "createdAt": "1700000000000",
      "updatedAt": "1700000000000",
      "travelRuleContactEmail": "[e-mail]",
      "gleifData": {
        "lei": "529900HNOAA1KXQJUQ27",
        "legalName": "Example Corporation Ltd.",
        "legalAddressCountry": "US",
        "legalNameLanguage": "en",
        "otherNames": [
          {
            "name": "ExCorp",
            "language": "en"
          },
          {
            "name": "Example Corp",
            "language": "en"
          }
        ],
        "legalAddressRegion": "NY",
        "nextRenewalDate": "2025-12-31T00:00:00Z"
      }
    }
  ],
  "total": 5,
  "next": "eyJpZCI6IjEyMyJ9"
}

Query Parameters

vaultAccountId · string<numeric>

The ID of the vault account. When provided, returns the legal entity associated with that vault account and pagination parameters are ignored.

pageCursor · string

Cursor string returned in next or prev of a previous response. Ignored when vaultAccountId is provided.

pageSize · integer · default: 50

Maximum number of registrations to return. Ignored when vaultAccountId is provided.

Required range: 1 <= x <= 100

Response

200

application/json

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

Paginated response containing a list of legal entity registrations

data · object[] · required

Legal entity registrations for the current page

Show child attributes

total · integer

Total number of legal entity registrations (optional)

Example:

5

next · string

Cursor to pass as pageCursor to retrieve the next page

Example:

"eyJpZCI6IjEyMyJ9"