FIfireblocks
Compliance

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

get/legal_entities

Request

Query parameters

vaultAccountIdstring numeric

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

pageCursorstring

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

pageSizeinteger

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

Response

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

totalinteger

Total number of legal entity registrations (optional)

nextstring

Cursor to pass as pageCursor to retrieve the next page

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.