Skip to main content
customerRefId is an optional identifier that Fireblocks forwards to your AML/KYT provider, so you can match a transaction, wallet, or account to your own record in the provider’s system. It is a reference field only: it is not a Trigger (Screening Policy) condition and does not affect any Outcome (Post-Screening Policy).

​
Choose a value

Use an anonymized token, such as a UUID, that you map to the customer in your own systems; Fireblocks does not store client PII. The value must match ^[-_:a-zA-Z0-9]*$: letters, digits, hyphens, underscores, and colons.

​
Which value applies

Fireblocks uses the first value it finds, in this order:
  1. The transaction’s own destination value.
  2. For incoming transactions, the deposit address’s value.
  3. The vault account’s value.
  4. An external or unmanaged wallet’s value.
  5. A workspace-wide default, if set.
If none is set, Fireblocks sends the literal value DEFAULT.

​
What you can do through the API

Setting it on a vault account or deposit address requires the Admin or Non-Signing Admin role.

​
Examples

On a vault account:
Per destination on a transaction:

​
Limitations

  • API only; there is no Console field.
  • Sent only to your own AML/KYT provider, never to the counterparty or receiving institution.

​
On the Help Center

There is no Help Center equivalent; Customer Reference ID is available through the API only.