FIfireblocks
Compliance

Register a new legal entity

Registers a new legal entity for the workspace using its LEI (Legal Entity Identifier) code. The LEI is validated against the GLEIF registry. Each workspace can register multiple legal entities. Endpoint Permission: Admin, Non-Signing Admin.

post/legal_entities

Request

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

leistring required

Legal Entity Identifier (LEI) code to register. Must be a valid 20-character LEI present in the GLEIF registry.

travelRuleProvidersTravelRuleProvider[]

Travel rule providers to associate with this registration

travelRuleContactEmailstring email

Contact email for travel rule communications

Example request

{
  "lei": "529900HNOAA1KXQJUQ27",
  "travelRuleProviders": [
    "MY_OWN"
  ],
  "travelRuleContactEmail": "compliance@example.com"
}

Response

Legal entity registered successfully

idstring uuid required

Unique registration identifier

leistring required

Legal Entity Identifier (LEI) code

status'PENDING' | 'APPROVED' | 'DENIED' | 'REVOKED' required

Approval status of a legal entity registration

isDefaultboolean required

Whether this is the default legal entity for the workspace

travelRuleProvidersTravelRuleProvider[] required

Travel rule providers configured for this registration

travelRuleContactEmailstring email

Contact email for travel rule communications

createdAtstring required

Creation timestamp in milliseconds since epoch

updatedAtstring required

Last update timestamp in milliseconds since epoch

Example response

{
  "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"
}

Changes

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