Legal Entity Setup

A Legal Entity Identifier (LEI) is the 20-character GLEIF code that identifies a legal entity across jurisdictions. Registering one is optional if you only look up others in Address Registry, and required to return verified data and to use About Address Registry Screening. If you don’t have an LEI, Fireblocks can help you obtain one from a partner during setup in the Console.

This legal entity is separate from the Travel Rule legal entity you create for Sumsub or GTR. Creating one does not create or change the other.

What you can do through the API

Task	Console	API
Register a legal entity	Yes	`POST /legal_entities`
List your legal entities	Yes	List legal entities
Get one legal entity	Yes	Get a legal entity
Update a legal entity	Yes	Update legal entity
Delete a legal entity	Yes	`DELETE /legal_entities/{legalEntityId}`
List the vault accounts mapped to an entity	Yes	List vault accounts for a legal entity
Assign vault accounts to an entity	Yes	Assign vault accounts to a legal entity

Step 1: Register your legal entity

Requires the Admin or Non-Signing Admin role. Accepts an optional Idempotency-Key header.

Field	Description
`lei`	Required. A valid 20-character LEI present in the GLEIF registry.
`travelRuleProviders`	The Travel Rule providers to show counterparties, using short provider codes (for example `NOTABENE`, `MY_OWN`).
`travelRuleContactEmail`	The contact email for Travel Rule communications.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "lei": "529900HNOAA1KXQJUQ27",
  "status": "PENDING",
  "isDefault": false,
  "travelRuleProviders": ["MY_OWN"],
  "travelRuleContactEmail": "compliance@example.com",
  "gleifData": {
    "lei": "529900HNOAA1KXQJUQ27",
    "legalName": "Example Corporation Ltd.",
    "legalAddressCountry": "US",
    "legalAddressRegion": "NY",
    "nextRenewalDate": "2025-12-31T00:00:00Z"
  }
}

Fireblocks validates the LEI against GLEIF and reviews the registration. A workspace can register several legal entities.

Status	Meaning
`PENDING`	Under Fireblocks review. Your addresses appear as unverified in the meantime.
`APPROVED`	Verified. Lookups against your addresses return your entity name, jurisdiction, and LEI.
`DENIED`	Rejected. You can see the reason and resubmit.
`REVOKED`	Previously approved, then revoked because the LEI expired or became invalid.

Step 2: Map vault accounts

When Fireblocks approves your first LEI, every vault account maps to that entity by default. If you register more entities, assign specific vault accounts to them. An explicit assignment takes precedence over the default.

Limitations

Each vault account belongs to at most one legal entity.
Denied or revoked LEIs: your addresses appear to counterparties as unverified, as before you registered, until you resubmit and Fireblocks approves it.
Address Registry limitations apply: not available on European or Swiss-hosted workspaces, or on Developer Sandbox workspaces.

On the Help Center

To register your legal entity in the Console, see Legal Entity Setup.

Get Started

Transactions

API Co-Signers

Webhooks

Workspace & Security

Identity & Compliance

Manage Wallets

Smart Contracts & Tokenization

Treasury & Trading

Gas Management

Payments

Embedded Wallets

Offchain Signing

Direct Custody Wallets

Integrations

Assets & NFTs

Canton

Key Link

What you can do through the API

Step 1: Register your legal entity

Step 2: Map vault accounts

Limitations

On the Help Center

​What you can do through the API

​Step 1: Register your legal entity

​Step 2: Map vault accounts

​Limitations

​On the Help Center

What you can do through the API

Step 1: Register your legal entity

Step 2: Map vault accounts

Limitations

On the Help Center