Overview

This page covers API errors associated with the Fireblocks Embedded Wallet. For more information about other Fireblocks API errors, visit our Fireblocks API Reference.

Every error is accompanied by the correct HTTP error code and a message structured as follows:

{
	error: 'HTTP Error description',
	message: 'Error message'
}

4XX errors

400 - Bad Request

Error Name	Error Message
No active webhook subscriptions	The workspace was not configured with a Webhook endpoint that is required for NCW async communication.
Unsupported algorithm	The provided algorithm for MPC key generation is not supported. Learn more here.
Pagination limit too large	The provided pagination limit parameter is higher than 50.
Validation failed (numeric string is expected)	The API call was made with an invalid NCW wallet identifier or account ID.

403 - Forbidden

Error Name	Error Message
Wallet disabled	The requested NCW is disabled. Learn more here.
Device disabled	The requested device is disabled. Learn more here.
Tenant disabled	The entire Fireblocks workspace is disabled.

404 - Not Found

Error Name	Error Message
Wallet not found	The provided wallet ID was not found.
Device not found	The provided device ID was not found.
Tenant not found	The provided tenant ID was not found.

409 - Conflict

Error Name	Error Message
Incomplete MPC Setup	The MPC Key generation was not completed.
Ongoing setup already in motion	MPC Key generation ceremony is in process.

1XXX errors

1000 - Incomplete Wallet

Error Name	Error Message
Incomplete Wallet	None of the devices in the Wallet have a COMPLETE status. Learn more here.

1001 - Incomplete Device

Error Name	Error Message
Incomplete Device	The device key status is in status INCOMPLETE. Learn more here.

1002 - Incomplete Backup

Error Name	Error Message
Incomplete Backup	The device key was not backed up. Learn more about backups here and multiple algorithms here.

1003 - Unsupported Algorithms

Error Name	Error Message
Unsupported Algorithms	The Algorithm is not supported by the workspace. Learn more here.