> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Legal Entity Setup

> Register your Legal Entity Identifier (LEI) so counterparties see verified data when they look up your addresses, and map vault accounts to legal entities through the Fireblocks API.

Register your Legal Entity Identifier (LEI) to appear as a verified entity when counterparties look up your addresses in [Address Registry](/reference/address-registry). An LEI is a standardized 20-character code, maintained by the Global Legal Entity Identifier Foundation (GLEIF), that identifies a legal entity across jurisdictions.

Registering is optional if you only want to look up others. It is required to return verified data to counterparties and to use [Address Registry](/reference/address-registry) in your compliance policy. If you do not have an LEI, Fireblocks can help you obtain one from a partner during setup in the Console.

## Register your legal entity

Register with [`POST /legal_entities`](/api-reference/compliance/register-a-new-legal-entity). It requires the Admin or Non-Signing Admin role, and 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. |

```json theme={"system"}
{
  "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. |

While an LEI is denied or revoked, your addresses appear to counterparties as unverified, as they did before you registered, until you resubmit and Fireblocks approves it.

## Map vault accounts to legal entities

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 with [Assign vault accounts to a legal entity](/api-reference/compliance/assign-vault-accounts-to-a-legal-entity). An explicit assignment takes precedence over the default, and each vault account can belong to at most one legal entity.

| Task | Endpoint |
| - | - |
| List your legal entities | [List legal entities](/api-reference/compliance/list-legal-entities-paginated) |
| Get one legal entity | [Get a legal entity](/api-reference/compliance/get-a-legal-entity) |
| Update a legal entity | [Update legal entity](/api-reference/compliance/update-legal-entity) |
| List the vault accounts mapped to an entity | [List vault accounts for a legal entity](/api-reference/compliance/list-vault-accounts-for-a-legal-entity-paginated) |
| Assign vault accounts to an entity | [Assign vault accounts to a legal entity](/api-reference/compliance/assign-vault-accounts-to-a-legal-entity) |

## On the Help Center

To register your legal entity in the Console, see [Legal Entity Setup](https://support.fireblocks.io/hc/en-us/articles/30614363410844-Legal-Entity-Setup).