To appear as a verified entity when counterparties look up your addresses, register your Legal Entity Identifier (LEI) with Fireblocks. An LEI is a standardized 20-character code, maintained by the Global Legal Entity Identifier Foundation (GLEIF), that uniquely identifies a legal entity across jurisdictions.
Registering an LEI is optional if you only want to query addresses yourself. It is required to return verified data to counterparties, and to use Address Registry in your compliance policy. See About Address Registry for what verified data means.
Register your LEI
- Go to Security > Policies > Compliance > Address Registry > Add Legal Entity.
- Enter your default LEI. You can look it up on the GLEIF website. If you do not have one, Fireblocks can help you obtain one from a partner directly within this setup flow.
- Select Verify. Fireblocks reviews and approves your submission.
- Map your vault accounts to the correct legal entities. Each vault account can be mapped to one entity at a time.
- Optionally, declare your Travel Rule provider and a compliance contact email.
You can also register legal entities via the API.
After Fireblocks approves your first LEI, every vault account maps to that entity by default. If you register additional legal entities and want specific vault accounts to map to a different one, do that via the API.
LEI states
State |
What it means |
|---|---|
Pending |
Submitted and under Fireblocks review. Your addresses appear as unverified to counterparties during this time. |
Approved |
Verified by Fireblocks. Queries against your addresses return your legal entity name, jurisdiction, and LEI. |
Denied |
Rejected by Fireblocks. You can view the reason and resubmit. |
Revoked |
Previously approved, then revoked due to an expired or invalid LEI. |
FAQ
The questions below are the ones readers ask most often.
Can one vault account belong to more than one legal entity?
No. Each vault account maps to exactly one legal entity at a time.
What happens to my data if my LEI is denied or revoked?
Your addresses appear as unverified to counterparties, the same as before you registered, until you resubmit and Fireblocks approves it.
Developer portal
See Register a new legal entity for the API fields and endpoints. Registration is also covered in Address Registry.