This page covers API errors associated with the Fireblocks Embedded Wallet. 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.

Introduction

Errors & Statuses

Data Objects

API Endpoints

EW API errors

4XX errors

400 - Bad Request

403 - Forbidden

404 - Not Found

409 - Conflict

1XXX errors

1000 - Incomplete Wallet

1001 - Incomplete Device

1002 - Incomplete Backup

1003 - Unsupported Algorithms

​4XX errors

​400 - Bad Request

​403 - Forbidden

​404 - Not Found

​409 - Conflict

​1XXX errors

​1000 - Incomplete Wallet

​1001 - Incomplete Device

​1002 - Incomplete Backup

​1003 - Unsupported Algorithms

4XX errors

400 - Bad Request

403 - Forbidden

404 - Not Found

409 - Conflict

1XXX errors

1000 - Incomplete Wallet

1001 - Incomplete Device

1002 - Incomplete Backup

1003 - Unsupported Algorithms