---
title: "Register a new legal entity"
method: POST
path: "/legal_entities"
tags: ["Compliance"]
---

# Register a new legal entity

`POST /legal_entities`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/legal_entities`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/legal_entities/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Headers

- `Idempotency-Key` string

## Request body

- RegisterLegalEntityRequest: Request body to register a new legal entity
  - `lei` string, required: Legal Entity Identifier (LEI) code to register. Must be a valid 20-character LEI present in the GLEIF registry.
  - `travelRuleProviders` TravelRuleProvider[]: Travel rule providers to associate with this registration
  - `travelRuleContactEmail` string, email: Contact email for travel rule communications

## Response `201`

Legal entity registered successfully

- LegalEntityRegistration: Legal entity registration record
  - `id` string, uuid, required: Unique registration identifier
  - `lei` string, required: Legal Entity Identifier (LEI) code
  - `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'REVOKED', required: Approval status of a legal entity registration
  - `isDefault` boolean, required: Whether this is the default legal entity for the workspace
  - `travelRuleProviders` TravelRuleProvider[], required: Travel rule providers configured for this registration
  - `travelRuleContactEmail` string, email: Contact email for travel rule communications
  - `gleifData` GleifData: GLEIF (Global Legal Entity Identifier Foundation) data for a legal entity
    - `lei` string, required: Legal Entity Identifier (LEI) code
    - `legalName` string, required: Official legal name of the entity
    - `legalNameLanguage` string: Two-letter ISO 639-1 language code
    - `otherNames` GleifOtherLegalEntityName[]: Alternative names for the entity
      - `name` string, required: Alternative name of the legal entity
      - `language` string, required: Two-letter ISO 639-1 language code
    - `legalAddressRegion` string: Region or state of the legal address
    - `legalAddressCountry` string, required: Country code of the legal address (ISO 3166-1 alpha-2)
    - `nextRenewalDate` string, date-time: Date when the LEI registration must be renewed
  - `createdAt` string, required: Creation timestamp in milliseconds since epoch
  - `updatedAt` string, required: Last update timestamp in milliseconds since epoch

## Other responses

- `400`: Invalid LEI or request parameters
- `404`: LEI not found in the GLEIF registry
- `409`: A legal entity with this LEI is already registered for the workspace
- `500`: Internal Server Error
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)