API Responses

HTTP Status Codes

200 (OK)

The request was processed as expected.

400 (INVALID_REQUEST)

The request is not well-formed, violates schema, or has incorrect fields.

401 (NOT_AUTHORIZED)

The API key doesn't match the signature or have the necessary permissions to perform the request.

403 (FORBIDDEN)

The API key doesn't have the necessary permissions to complete the request.

404 (RESOURCE_NOT_FOUND)

The requested resource doesn't exist.

429 (RATE_LIMIT_REACHED)

Too many requests. Blocked due to rate limiting.

5XX

Something went wrong on Fireblocks' end.

API Error Codes

The table below contains all error codes (and their related HTTP status codes) for the Fireblocks API. We recommend reviewing the codes related to the features you want to implement for your workspace and customers.

4XX Error Codes

Error Code

HTTP Status Code

Relevant Features

Issue and Remediation

-1

401

All

Invalid signature
If you receive this error message, ensure the private key you used is correct.

-2

401

All

Missing API Key in the JWT
Verify that you specify the API key

-3

401

All

The entire JWT is missing

  • Uncommon_ - Potential code change, or bad parameters passed to Fireblocks SDK constructor

-4

401

All

Wrong URL in the JWT

  • Uncommon_ - Potential code change to the Fireblocks SDK source code on your device

-5

401

All

Unauthorized: Invalid token format
This error code typically indicates the certificate associated with the API user making the call has expired.

-6

401

All

Wrong User in the JWT
The user that is being used as part of the request is incorrect, verify that the correct user is being used

-7

401

All

Unauthorized: Token was not accepted
This error code typically indicates the JSON Web Token (JWT) supplied with the API user’s request was not accepted. API requests to Fireblocks are authenticated using the provided JWT. If the JWT is invalid, you will receive the error code. The cause of the error is likely either the wrong API key being used or the wrong baseURL being used.

For SDK users, this typically means an incorrect API key was used to create the client. For users with native API client implementations, this typically indicates an error with your JWT creation logic.

-8

401

All

Insufficient permissions
This error code typically indicates the API user initiating this request does not have access to the requested operation based on their user role

-10

401

All

The request has expired
This error typically indicates the JSON Web Token (JWT) supplied with the API user’s request has timed out.

Please note:

  • For Fireblocks SDK users, the JWT expiration time is defined based on the system time.
  • For users with their own API client implementations, the JWT data is defined by the user’s implementation.

-12

401

All

The request is with a future issuance timestamp (iat)
This error code typically indicates the JSON Web Token (JWT) supplied with the API user’s request is not yet valid for processing.

  • For SDK users, the JWT “initiated–at” time is defined based on the system time.
  • For users with their own API client implementations, the JWT data is defined by the user’s implementation.

1000

400

Vault

GetVaultAccounts request has invalid values
Check that you pass a valid minAmountThreshold (if you pass it) and only one of namePrefix, nameSuffix if you pass it

1002

400

Vault

Create Vault Account failed
Verify that the values provided to the create vault account request are valid and conform to the types specified in the API Docs

1004

404

Vault

Vault account Id was not found
Verify that the vault account you're trying to query is valid and exists

1006

404

Asset, Balance

Asset doesn't exist
The asset requested for the given vault account does not exist, verify that the vault account contains the asset you're requested.

1008

400

Wallet, Asset (EOS Specific)

EOS Wallet Creation failed
The eosAccountName parameter is invalid

1010

400

Wallet

Renaming a deposit address failed
You're trying to add an address to a blockchain which does not support more than 1 address (such as ETH)

1013

400

Vault

Vault account renaming failed
Verify that the parameters passed to the vault account renaming operation are valid

1015

400

Wallet

Rename a deposit address failed
Verify that the parameters that were passed are valid and that the asset you're trying to rename exists

1016

400

Wallet

Rename a deposit address failed
The rename operation failed due to a backend issue - open a ticket to support

1017

400

Vault

Hide vault account failed
The vault account you requested to hide does not exist, please verify you're using the correct vault account id

1019

400

Vault

Hide on a hidden vault account request
You're requesting to hide a vault account that is already hidden, please verify you're using the correct vault account id

1020

400

Vault

Unhide vault account failed
The vault account you requested to unhide does not exist, please verify you're using the correct vault account id

1022

400

Vault

Unhide on a visible vault account request
You're requesting to unhide a vault account that is not hidden, please verify you're using the correct vault account id

1023

400, 404

Wallet

Get legacy address failed
There is no legacy address used for this specific asset

1024

400, 404

Wallet

Get legacy address for an asset without one
The asset you're trying to get the legacy address for does not have one (for example ETH)

1025

400

Asset, Vault, Wallet

Usage of an unsupported asset
The asset you specified in your request is invalid, please check it against the supported asset list

1026

400

Asset, Vault, Wallet

Creation of a wallet that already exists
You've requested to create a wallet for an asset that already has a wallet in the vault account, please check you're using the correct asset and correct asset

1027

400

Asset, Balance

Requested max spendable amount for asset that doesn't support that request
You've requested to know the max spendable amount for an asset which does not support this request, verify you're using one of the assets according to the API docs

1028

400

Asset, Balance

Max Spendable Amount invalid value
The parameters you provided for the request are invalid, please verify you provided the correct type of values as well as a valid asset and vault account id

1031

400

Asset, Balance

Get balance by assets
The request to balance of assets in all vault accounts is invalid, only one of accountNamePrefix and accountNameSuffix can be provided

1032

400, 404

Asset, Balance

Get balances by assets or get balance for asset failed
The asset requested does not exist in the vault account

1034

400

Wallet

Create testnet asset failed
You're requested to create a testnet asset on a workspace that is does not have testnet support

1035

400

Asset

Activate wallet failed
The request to activate the wallet failed, please open a ticket to support

1037

400

Vault

Get vault accounts endpoint is disabled
Workspaces created after May 2022 do not support the get vault accounts endpoint, use the paged request

1038

400

Wallet, Asset

Adding a token without base asset
Before adding a token to the vault account, please create a base asset wallet

1039

400

Wallet, Asset

Insufficient base asset for token wallet
Before creating a token asset, make sure you have sufficient base asset to cover token transactions

1040

401

Vault

Unauthorized user to create vault account
The user that's trying to add a vault account does not have the proper permissions needed to create a vault account, make sure you use the correct user

1103

400

Exchange, Fiat

No such exchange/fiat account ID
The exchange or fiat account ID does not exist, make sure you're using the correct one

1105

400

Exchange

Exchange account for asset by ID does not exist
The exchange account's asset does not exist for the specified exchange account ID, make sure you're using the correct exchange account ID and asset

1106

400

Exchange Transfers

No such exchange account ID
The exchange account ID specified does not exist

1108

408

Exchange

Exchange timeout when adding an account
We faced an internal timeout when trying to add the exchange account

1111

400

Exchange Transfers

Exchange convert failed
Failed to perform a convert operation, please check the message reply to understand the issue

1202

400

Internal Wallets

Create internal wallet failed
Internal wallet name must be specified, not empty and to not already exist in a different wallet

1204

400

Internal Wallets

Get internal wallet by id failed
The internal wallet specified does not exist, make sure you're querying the correct internal wallet id

1206

400

Internal Wallets

Delete internal wallet failed
Failed to delete the internal wallet, please make sure you've specified the correct internal wallet parameters

1208

400

Internal Wallets

Create an internal wallet failed
Failed to create an internal wallet, please verify you've provided the correct parameters for the creation as per the API docs

1209

400

Internal Wallets

Getting the wallet's asset failed
The internal wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id

1212

400

Internal Wallets

Deleting specific asset from wallet failed
Please verify that you specified the correct wallet id and asset id for deletion

1213

400

Internal Wallets

Create an unsupported asset address in a wallet
The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use

1214

400

Internal Wallets

Create an asset from a different network in the wallet
The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate

1215

400

Internal Wallets

Add an asset in a wallet that already has it
You're trying to add an asset to the internal wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists

1216

400

Internal Wallets

Add an asset with an invalid address to the wallet
You're trying to add an asset to the internal wallet, but the address does not match the asset's conventions, please check the address you're trying to add

1302

400

External Wallets

Create external wallet failed
External wallet name must be specified, not empty and to not already exist in a different wallet

1304

400

External Wallets

Get external wallet by Id failed
The external wallet requested does not exist, please make sure you're using the correct wallet Id

1306

400

External Wallets

Delete internal wallet failed
Failed to delete the external wallet, please make sure you've specified the correct internal wallet parameters

1308

400

External Wallets

Create an internal wallet failed
Failed to create an external wallet, please verify you've provided the correct parameters for the creation as per the API docs

1309

400

External Wallets

Getting the wallet's asset failed
The external wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id

1312

400

External Wallets

Deleting specific asset from wallet failed
Please verify that you specified the correct wallet id and asset id for deletion

1313

400

External Wallets

Create an unsupported asset address in a wallet
The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use

1314

400

External Wallets

Create an asset from a different network in the wallet
The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate

1315

400

External Wallets

Add an asset in a wallet that already has it
You're trying to add an asset to the external wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists

1316

400

External Wallets

Add an asset with an invalid address to the wallet
You're trying to add an asset to the external wallet, but the address does not match the asset's conventions, please check the address you're trying to add

1351

400

External Wallets

Create external wallet failed
External wallet name must be specified, not empty and to not already exist in a different wallet

1354

400

External Wallets

Get external wallet by Id failed
The external wallet requested does not exist, please make sure you're using the correct wallet Id

1356

400

External Wallets

Delete internal wallet failed
Failed to delete the external wallet, please make sure you've specified the correct internal wallet parameters

1358

400

External Wallets

Create an internal wallet failed
Failed to create an external wallet, please verify you've provided the correct parameters for the creation as per the API docs

1359

400

External Wallets

Getting the wallet's asset failed
The external wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id

1362

400

External Wallets

Deleting specific asset from wallet failed
Please verify that you specified the correct wallet id and asset id for deletion

1363

400

External Wallets

Create an unsupported asset address in a wallet
The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use

1364

400

External Wallets

Create an asset from a different network in the wallet
The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate

1365

400

External Wallets

Add an asset in a wallet that already has it
You're trying to add an asset to the external wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists

1366

400

External Wallets

Add an asset with an invalid address to the wallet
You're trying to add an asset to the external wallet, but the address does not match the asset's conventions, please check the address you're trying to add

1401

400

Transaction

The operation requested is not supported
The operation argument that you provided in the create transaction is not supported, please verify it's correct

1402

400

Transaction

Source balance insufficient
Balance of the source account is not sufficient to cover the transaction

1403

400

Transaction

Destination balance is insufficient
Some blockchains (such as NEAR) require a minimal amount of asset to be activated, you tried to pass less than the minimal amount, to a vault account which does not have such a wallet, thus the wallet can't be created
Please verify you're transferring a sufficient amount, or have the destination create a wallet and deposit a sufficient amount of base asset

1404

400

Transaction

Invalid Peer type
When creating the transaction, verify the the type of the source and destination are valid and one of the defined enums in the API docs

1405

404

Transaction

No such transaction
The transaction Id you used to try and get the transaction object is invalid and was not found in the system, make sure you're using the correct transaction Id

1406

400

Transaction

Failed to cancel transaction
Cancelling the transaction failed for some reason, please open a support ticket

1407

400

Transaction

User can't create a transaction
The user trying to create the transaction does not have sufficient permissions to do so, please verify the user's permission level and that you're using the correct user

1408

400

Transaction

Paged get tried to change direction
When getting transactions in a paged fashion, you can only go in one direction (forward or backwards) and can't change direction mid execution.
Make sure you're only querying the information in one direction

1409

400

Transaction

Transaction creation parameters are invalid
Here is a list of items to check:

  1. The asset type is valid and is supported
  2. You can only specify destination or destinations, not both
  3. For OTA you must specify the address
  4. Typed messages only supported BTC, LTC, DASH and ETH
  5. AML Customer reference ID is can only use -_: and alpha-numeric
  6. You can not have more than 650 destinations in the destinations parameters

1410

400

Transaction

Transaction destination wallet does not exist
The destination is sending the transaction to an external/internal/contract wallet by an Id, but the Id specified does not exist, check the Id you're using is correct

1411

400

Transaction

Transaction destination wallet asset does not exist
The destination is sending the transaction to an external/internal/contract wallet by an Id, but the asset used in the transaction does not exist, check that the asset has an address in the wallet Id

1412

400

Transaction

Transaction destination wallet address is suspended
The destination is an external/internal/contract wallet which was not approved yet, approve it and the try again

1421

400

Transaction

Confirmation number change failed
Changing the number of confirmations for the transaction failed, please verify that the transaction exists otherwise open a support ticket

1422

400

Transaction

Confirmation number change failed
Changing the number of confirmations for the transaction by transaction hash failed, please make sure you're using the correct transaction hash, otherwise open a support ticket

1423

400, 404

Transaction

Get transaction by transaction hash failed
Couldn't find a transaction with the specified transaction hash, please verify the transaction hash and try again

1424

400

Transaction, Network Connection

Destination address invalid
Here is a list of parameters to check:

  1. The address used is invalid for the asset you're using
  2. The target (in case of a network transfer) does not contain a wallet for the specified asset
  3. You're using the internal/external/contract wallet for a different workspace than the one you're performing the transaction on
  4. You trying to send a transaction to a network connection which you do not have
  5. You're using destinations one of the destinations is a network connections - this is not supported

1425

400

Transaction

Missing a tag
You're trying to send a transaction to an address that requires a tag, please verify you're providing a tag

1426

400

Transaction

Unfreeze failed
You tried to unfreeze a transaction, but it is not rejected nor failed by AML therefore it can't be unfrozen

1427

400

Transaction

Source type of transaction is invalid
You tried to send a transaction with the source being invalid, verify that the source is one of: VAULT_ACCOUNT, EXCHANGE_ACCOUNT, GAS_STATION or FIAT_ACCOUNT

1428

400

Transaction

Destination of transaction is invalid
The destination type of one of the destinations is not one of the defined enum in the API docs, verify that it is correct and try again

1429

400

Asset, Transaction

Validate address failed
The asset you tried to use for the validate_address endpoint is not supported

1431

400

Asset, Transaction

Validate address didn't find an address
The address provided to the validate_address endpoint is invalid.

1432

400

Transaction

Invalid amount specified
The amount must be a number of a numeric string, verify it is so

1433

400

Transaction

Invalid tag specified
The tag / memo specified does not comply with the rules of the blockchain, verify the tag / memo is valid

1434

400

Transaction

Freeze failed
Freeze can only be done in confirming or completed state, the transaction you're trying to freeze is in neither of those states thus can't be frozen

1435

400

Transaction

List unspent for unknown asset
You tried to get the unspent inputs (UTXO) for an asset that does not have such values or no UTXOs exist

1437

400

Exchange, Transaction

Unsupported transfer
Direct transfers (Exchange to OTA) is not supported for Kraken exchange

1438

400

Transaction

External Tx ID Duplicate
The externalTxId specified in the transaction was already used in the past, please use a different one

1439

404

Transaction

No such External Tx ID
The external Tx ID used does not exist, please verify the external Tx ID you're using

1440

400

Transaction

Drop for unsupported blockchain
You're trying to run a drop transaction request for a blockchain that is not ETC or ETH

1441

400

Transaction

Replace by fee too low
You're attempting to perform a RBF transaction but the gas price you specified is too low, please check it and submit a higher gas price

1443

400

Transaction

Too late for RBF
You're trying to replace by fee, but the transaction was already mined

1445

403

Transaction

User can't freeze
The user that's trying to perform a freeze does not have the permissions to perform this, check the user's permissions and that you're using the correct user

1446

403

Transaction

User can't unfreeze
The user that's trying to perform a unfreeze does not have the permissions to perform this, check the user's permissions and that you're using the correct user

1448

400

Transaction

Fee payer is not allowed for asset
You're trying to define a fee payer for an asset which does not support it, please check whether the asset you're using allows for a fee payer configuration

1449

400

Transaction

Fee payer can't pay
The defined fee payer does not have a wallet with the base asset to pay the fee, verify that you specified the correct fee payer and check that it contains a base asset wallet with a sufficient amount to pay for the transaction

1450

400

Transaction

Transactions are blocked for this blockchain
We have temporarily disabled transactions for the specified blockchain, check the status page for more details

1451

400

Transaction

Transaction confirmations don't match Fireblocks restrictions
Fireblocks requires a specific number or a minimum number of confirmations for some blockchains. Manually setting confirmations for a transaction must meet these requirements. For more, see Deposit Control & Confirmation Policy.

1502

400

Asset, Transaction

Trying to use a deprecated asset
The asset specified in the transaction is deprecated and can't be used, please check the asset and use a different one

1503

400

Asset, Balance, Transaction

Unsupported asset
The asset specified is not supported, please check the asset you've specified

1601

404

Network Connection

Network Connection Id does not exist
The network connection you're trying to query by id does not exist, please check the Id you're using

1603

400

Network Connection

Delete Network Connection but id is not specified
The delete network connection request does not have a connectionId parameter specified, please make sure one is provided and is exists

1604

400

Network Connection

Create a network connection failed
The network connection creation failed, check the error message for more information and open a support ticket if insufficient

1605

404

Network Connection

Get Network Connection for unknown id
The network connection Id provided could not be found, please verify you're using the correct id

1606

404

Network Connection

Delete network connection for unknown id
The network connection Id provided could not be found, please verify you're using the correct id

1607

400

Network Connection

Setting the routing policy for a network connection failed
Verify that you used the proper parameters for the call

1608

404

Network Connection

Set routing policy for an unknown network connection id
The id you provided for the call was not found, verify you're using the correct id and it exists

1609

400

Network Connection

Validating routing policy failed
The attempt to validate whether the network connection's routing will lead to a third party or not for a given asset failed, please verify you passed the correct parameters and open a support ticket if needed

1610

404

Network Connection

Validating routing policy for an unknown network connection id
The id you provided for the call was not found, verify you're using the correct id and it exists

1611

403

Network Connection

No multiple network profiles
The workspace does not support multiple network profiles. Contact us to request support

1612

422

Network Connection

The counterparty rejected the connection request
The Counterparty has to send a connection request.

1613

422

Network Connection

The counterparty is already an active connection
The network connection already exists

1614

422

Network Connection

The connection is pending approval
You can request approval from the workspace admins

1615

422

Network Connection

The connection is pending approval
You can request approval from your counterparty

1616

403

Network Connection

Network connection cannot be deleted
There is an active Smart Transfers ticket with the connection which must be closed before deleting the Network connection

9007

404

Network Connection

The Fireblocks Network is not activated in the workspace
Reach out to support to resolve this

9011

403

Network Connection

Cannot delete network ID
The default ID cannot be deleted before making another ID the default

9012

403

Network Connection

Network profile cannot be deleted
It is the last remaining ID. There must be at least one Network profile per tenant

9013

403

Network Connection

Network profile cannot be deleted
There is an active Smart Transfers ticket with the Network profile which must be closed before deleting the Network profile

9014

422

Network Connection

Invalid network name
The name cant contain the ”<” and “>” characters

9015

403

Network Connection

Could not add an additional network ID
Contact customer support to activate the feature

9016

422

Network Connection

The selected asset is not supported on the Fireblocks Network
Reach out to support to resolve this

9017

422

Network Connection

Invalid routing policy > non-custom scheme
A routing destination type or ID is required

9018

422

Network Connection

Invalid routing policy > destination ID incompatible with selected asset.
Make sure you are sending a supported asset

9019

422

Network Connection

Invalid routing policy > selected routing policy is not allowed
Select a valid routing policy

9020

422

Network Connection

Invalid routing policy > selected routing destination is not supported
Select one of the supported destinations

9021

422

Network Connection

Invalid routing policy > selected crypto destination is not supported
Select a vault or a connected exchange account.

9022

422

Network Connection

Invalid routing policy > third-party account provided is invalid
Make sure you are adding a supported third party destination

1706

400

FIAT Accounts

FIAT Account id provided is unknown
The exchange account id you provided was not found, please verify you're using the correct account id

1708

400

FIAT Accounts

FIAT Account id provided is unknown
The exchange account id you provided was not found, please verify you're using the correct account id

1901

400

Asset, Transaction

Estimate fee for unknown asset
The asset you specified for the estimate fee call is unknown, please make sure you're using a supported and known asset

1902

400

Asset, Transaction

Estimate fee for an invalid asset
The asset you specified does not support the estimate fee call, please make sure you're using a supported and allowed asset

1904

400

Asset, Transaction

Estimate fee with invalid parameters
Make sure when calling estimate fee you do not have destination and destinations parameters both used, and that the source parameter is a vault account

1905

400

Asset, Transaction

Estimate fee failed due to insufficient funds
The funds you have in the source vault are not sufficient, and thus the estimate fee call failed, make sure you have sufficient base asset in the source vault and try again

1907

400

Asset, Transaction

Estimate fee failed due to smart contract error.
The transaction reverted during its simulation as part of estimating the gas limit. There are three ways to properly handle this error:

  1. Initiate the transaction again while using different parameters.
  2. Try using a different vault to perform the transaction.
  3. Read the contract’s source code to better understand the error.

2002

400

Public Key

Public key could not be found
Make sure that the information you provided to the public key query is valid and a wallet for this asset exists in the specified vault account

2101

400

Gas Station

Invalid gas station parameters
When editing gas station configuration make sure you provide both gasCap and gasThreshold

2110

400

Gas Station

Invalid asset for gas station
When editing gas station configuration, the asset you specified is not supported for this operation, make sure you're using a support and valid asset

2201

400

Balance, Private Ledger

Lock/Release allocation for unsupported asset
The asset you specified in the lock or release allocation call is not supported, make sure it is a valid and supported asset

2202

400

Balance, Private Ledger

Lock/Release Allocation for unknown account
The virtual account you specified does not exist, please make sure you're using a valid virtual account that exists

2204

400

Private Ledger, Off-Exchange

Allocation not allowed
The vault account you specified does not have off-exchange set-up, therefore locking allocation is not allowed, make sure you have off-exchange set and then try again

2205

400

Private Ledger, Balance

Insufficient amount for fee in allocation
The call you're trying to perform requires that a sufficient amount for the fee bank is also allocated, the allocation amount you've specified does not meet this demand, please increase the allocation amount

2501

400

Webhooks

Resend webhook for specific tx id failed
Make sure one of the parameters resendCreated and resendUpdated is marked as true and try again

2602

404

Off-Exchange

Unknown virtual account id
Virtual account id specified does not exist, make sure you're using a virtual account id that exists

2604

404

Off-Exchange

Unknown virtual account id
Virtual account id specified does not exist, make sure you're using a virtual account id that exists

2702

403

Users

Insufficient permissions for operation
The user that's trying to perform this call does not have sufficient permissions for it, make sure you're using the correct user and they have the proper permissions to view the user list

2814

400

Fee Payer

Fee Payer not configured
No fee payer was configured for this workspace, configure one and try again

2816

400

Fee Payer

Asset wallet does not exist
You've attempted to set a fee payer by specifying a vault account and asset, however the specified asset does not have a wallet in the specified vault account, please create a wallet in the specified vault account and fund it then try again

2817

400

Fee Payer

Non-base asset
You've specified a fee payer asset which is not the base asset, this is not allowed, please specify the base asset and try again

2818

400

Fee Payer

Unsupported asset
You've tried to set a fee payer for an asset which is not supported, please verify you're using a supported asset and try again

2902

403

Audits

Getting audits is not allowed
The user trying to get the audits is not allowed to due so due to a permissions matter, make sure that the user has the proper permissions and that you're using the correct user

3001

404

Smart Transfers

Ticket not found
Fireblocks could not find the Smart Transfer ticket.

3002

403

Smart Transfers

Ticket should be open
The attempted action can only be performed on an open Smart Transfer ticket.

3003

403

Smart Transfers

Ticket should be draft
The attempted action can only be performed on a Smart Transfer ticket draft.

3004

403

Smart Transfers

Ticket should be draft or open
The attempted action can only be performed on an open Smart Transfer ticket or a Smart Transfer ticket draft.

3005

403

Smart Transfers

Ticket action allowed for owner
Only the Smart Transfer ticket creator can perform the attempted action.

3006

403

Smart Transfers

Ticket cancel can be done by payer
You cannot close the Smart Transfer ticket because the connection already funded it.

3007

403

Smart Transfers

Ticket terms are missing
You must define all required terms before you can open the Smart Transfer ticket.

3008

403

Smart Transfers

Ticket expiration date passed
The Smart Transfer ticket has expired.

3009

400

Smart Transfers

Term not found
No Smart Transfer ticket term matches your search criteria.

3010

403

Smart Transfers

Term should be created status
The submitted or updated Smart Transfer ticket term is incorrect.

3011

403

Smart Transfers

Term should be funded status
Only a funded Smart Transfer ticket can be closed.

3012

403

Smart Transfers

Term should be funding failed status
The attempt to fund the Smart Transfer ticket failed.

3013

403

Smart Transfers

Term amount required
You must enter a term amount before you can open a Smart Transfer ticket.

3014

403

Smart Transfers

Term asset required
You must select an asset before you can open a Smart Transfer ticket.

3015

403

Smart Transfers

Term asset not supported
Fireblocks does not support the selected asset for Smart Transfer tickets.

3016

403

Smart Transfers

Term from to should be different
The Smart Transfer ticket must include two different connections.

3017

403

Smart Transfers

Term amount is different than fund amount
The entered fund amount does not match the term amount on the Smart Transfer ticket.

3018

403

Smart Transfers

Term asset is different than fund asset
The asset selected for funding does not match the term's asset on the Smart Transfer ticket.

3019

403

Smart Transfers

Counterparty not found
Fireblocks could not find the counterparty connection.

3020

403

Smart Transfers

Network does not belong to tenant
You can only open a Smart Transfer ticket using a Fireblocks Network profile belonging to you.

3021

403

Smart Transfers

Networks not connected
The selected counterparty is not a Fireblocks Network connection.

3022

403

Smart Transfers

Term should be created or funding failed status
The Smart Transfer ticket has already been funded or is currently being funded.

3023

403

Smart Transfers

Term transaction can be made by counterparty of term who should pay
Your Fireblocks Network profile cannot fund the Smart Transfer ticket.

3024

403

Smart Transfers

Network connection does not belong to peers
The Fireblocks Network connection funding the Smart Transfer ticket does not match the connection listed on the term.

3025

403

Smart Transfers

Transaction fee and fee level defined
You cannot set a fee level (low, medium, or high) and specify a custom fee at the same time.

3027

403

Smart Transfers

Tickets can have at most two terms
Smart Transfer tickets can only have two transfer terms.

3029

403

Smart Transfers

Network doesn't have FF enabled
The Fireblocks Network connection does not use the Smart Transfer feature.

3030

400

Smart Transfers

Ticket missing expire in
You must set an expiration date before you can open a Smart Transfer ticket.

3031

403

Smart Transfers

Ticket creator must receive asset
You can only open a Smart Transfer ticket for receiving assets.

9001

400

Wallet

Invalid customer reference id
The customer reference id specified is invalid, make sure it only consists of \-\_:a-zA-Z0-9

9003

400

Transaction

Invalid idempotency key length
The idempotency key must be no longer than 40 characters, please verify that if you've specified one, it has a proper length

Idempotency key used on internal error request, returning bad request
This operation doesn't support the usage of the same idempotency key after an internal error

9005

400

Transaction

A transaction with the same idempotency key is in progress
Please wait until the previous transaction for this idempotency key is done before issuing a new one

9006

400

Network Connection

Missing required parameter in request body
The request you've sent is missing the isDiscoverable parameter in the body, make sure it exists and is a boolean then try again

9007

404

Network Connection

Unknown network id
The network id specified could not be found, please verify it exists and try again

9009

400

Network Connection

Parameters passed are invalid
The parameters passed to the set_routing_policy call are invalid, please make sure they are correct and conform to the API docs then try again

11001

400

All

The specified vault account is invalid
Please make sure that the vault account you've specified is correct, valid and exists

12000

400

All

Cloud provider issue
There is an issue with one of our cloud providers, please check the status page for more details

5XX Error Codes

10XX codes

Error CodeFeatureDescription
1001VaultGet Vault accounts paged failed
1003VaultCreate vault account failed
1005VaultGet vault account failed
1007Asset, BalanceGet balance for vault account and asset failed
1009Wallet, AssetCreate wallet for asset failed
1011WalletAdding a new address failed
1012WalletGetting the addresses for the given asset failed
1014VaultRenaming a vault account failed
1018VaultHide vault account failed
1021VaultUnhide vault account failed
1029, 1030Asset, BalanceGet max spendable amount failed
1033AssetGet balance for assets or specific asset failed
1036AssetFetching max BIP44 index used failed

11XX codes

Error CodeFeatureDescription
1101Exchange, FiatFailed to get exchange/fiat accounts
1102ExchangeFailed to get exchange account by ID
1104ExchangeFailed to get exchange account by ID and asset
1107Exchange TransfersFailed to perform an exchange account transfer (internal transfer)
1110Exchange TransfersConvert operation failed

12XX codes

Error CodeFeatureDescription
1201Internal WalletsFailed to get internal wallets
1202Internal WalletsFailed to create an internal wallet
1203Internal WalletsFailed to get internal wallet by ID
1205Internal WalletsFailed to delete internal wallet
1207Internal WalletsFailed to create an internal wallet by asset
1210Internal WalletsFailed to get wallet by asset and wallet ID
1211Internal WalletsFailed to delete specific asset from wallet

13XX codes

Error CodeFeatureDescription
1301External WalletsFailed to get external wallets
1302External WalletsFailed to create an external wallet
1303External WalletsFailed to get external wallet by ID
1305External WalletsFailed to delete an external wallet
1307External WalletsFailed to create an external wallet by asset
1310External WalletsFailed to get wallet by asset and wallet ID
1311External WalletsFailed to delete specific asset from wallet
1350External WalletsFailed to get external wallets
1352External WalletsFailed to create an external wallet
1353External WalletsFailed to get external wallet by ID
1355External WalletsFailed to delete external wallet
1357External WalletsFailed to create an external wallet by asset
1360External WalletsFailed to get wallet by asset and wallet ID
1361External Walletsfailed to delete specific asset from wallet

14XX codes

Error CodeFeatureDescription
1404TransactionTransaction creation or get failed
1430Asset, TransactionValidate destination address endpoint failed
1436TransactionList unspent inputs (UTXO) failed
1444TransactionFailed to get the transactions list
1447TransactionFailed to get transaction by external Tx ID

15XX codes

Error CodeFeatureDescription
1501AssetGet supported assets failed

17XX codes

Error CodeFeatureDescription
1702Fiat AccountsGet fiat account by ID failed
1707Fiat AccountsRedeem funds to DDA failed
1709Fiat AccountsDeposit funds from DDA failed

19XX codes

Error CodeFeatureDescription
1903Asset, TransactionEstimate fee calculation failed

20XX codes

Error CodeFeatureDescription
2001Public KeyGetting public key information failed

21XX codes

Error CodeFeatureDescription
2102Fireblocks Gas StationSetting gas station information failed

22XX codes

Error CodeFeatureDescription
2203Balance, Private LedgerLock allocation call failed

25XX codes

Error CodeFeatureDescription
2501WebhookResend webhook failed

26XX codes

Error CodeFeatureDescription
2601Off-ExchangeGet off-exchange failed
2603Off-ExchangeCouldn't settle off-exchange with provided virtual account ID
2605Off-ExchangeFailed to get off-exchange with specified ID

27XX codes

Error CodeFeatureDescription
2701UsersFailed to get users for workspace

28XX codes

Error CodeFeatureDescription
2813Fee PayerFailed to get fee payer
2815Fee PayerSetting the fee payer failed
2819Fee PayerDeleting the fee payer configuration failed

29XX codes

Error CodeFeatureDescription
2901AuditsFailed to get audits