> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zodia-custody.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Codes

> Standard error codes returned by the Zodia API

Zodia's API offers a number of error codes to facilitate your usage and troubleshooting.
Zodia uses HTTP response codes to indicate the success or failure of an API request. In general:

* `200` indicate success
* `4xx` range indicate a failure given the information provided(e.g. a required parameter was omitted, etc...)
* `500` indicate an error with Zodia's servers

In addition to these HTTP response codes, Zodia provides in the response payload:

* an error code starting with `ER-` that should be shared with Zodia for troubleshooting
* a human-readable message providing more details about the errors

The table below describes some errors you may encounter:

| HTTP status code                                                    | Error code | Error message                                                                   | Description                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-101     | Missing mandatory field: *field\_name*                                          | A mandatory field is missing in the payload received by Zodia                                                                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-102     | Entity with id: *entity\_id* does not exist                                     | You are trying to use an entity (company, wallet, transaction, etc…) that does not exist                                                                                                                                                             |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-103     | Size of the field: *field\_name* must be between *min\_value* and *max\_value*  | Length of the value provided does not match the expected size                                                                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-104     | Entity with id: *entity\_id* already exists                                     | You are trying to create an entity (company, wallet, transaction, etc…) which already exists                                                                                                                                                         |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-107     | Field: *field\_name* must not be blank                                          | Field is missingValue of the field is empty                                                                                                                                                                                                          |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-108     | Field: *field\_name* does not match the expected pattern: *regexp\_value*       | You sent a value that does not match the pattern expected by Zodia                                                                                                                                                                                   |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-111     | Value of the field: *field\_name* is not a supported cryptocurrency             | The cryptocurrency provided is not currently supported by Zodia                                                                                                                                                                                      |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-112     | Field: *field\_name* must not be empty                                          | You sent an empty value/list while Zodia is expecting at least one value                                                                                                                                                                             |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-113     | Entity with id: *entity\_id* is deactivated                                     | You are trying to use a deactivated entity                                                                                                                                                                                                           |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-114     | Field: *field\_name* does not match with user's company                         | The value you provided for the field (usually "domainId") does not match your company's identifier                                                                                                                                                   |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-115     | Field: *field\_name* does not match with resource parameter: *path\_parameter*  | The value you provided in the payload does not match the path parameter used in the resource                                                                                                                                                         |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-116     | Value of the field: *field\_name* must contain only digits                      | You sent a value that is not a numeric value                                                                                                                                                                                                         |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-117     | Value of the field: *field\_name* must be equal to *value*                      | You must send a value strictly equal to the value expected by Zodia                                                                                                                                                                                  |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-121     | Field: *field\_name* must be greater than or equal to *value*                   | You must send a value greater than or equal to the value expected by Zodia                                                                                                                                                                           |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-122     | Field: *field\_name* must be less than or equal to *value*                      | You must send a value lesser than or equal to the value expected by Zodia                                                                                                                                                                            |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-124     | Only *max\_value* minutes of drift are allowed                                  | Zodia allows 5 minute of drift between the signed timestamp provided and the instant that Zodia receives the query                                                                                                                                   |
| [500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) | ER-128     | *currency\_value* is not a known currency                                       | Zodia was not able to verify the provided currency                                                                                                                                                                                                   |
| [500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) | ER-200     | Internal Error                                                                  | Internal service error                                                                                                                                                                                                                               |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-202     | Header: *header* must not be blank                                              | Header is missingValue of the header is empty                                                                                                                                                                                                        |
| [500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) | ER-206     | Unable to fetch data                                                            | Zodia was not able to fetch the data requested                                                                                                                                                                                                       |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-212     | Approval timeout                                                                | Transaction approval expires                                                                                                                                                                                                                         |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-214     | Transaction amount greater than available amount or fee amount                  | The transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-234     | Entity with id: *value* is not ready to be submitted                            | The id provided not allowed to be submitted                                                                                                                                                                                                          |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-253     | Not enough funds                                                                | The transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-255     | Insufficient funds available to cover transfer and fee                          | The transfer instruction cannot be created as there are not sufficient funds to pay for the amount and/or fee                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-260     | You are attempting to send to an invalid address                                | The transfer instruction has been rejected due to sender or recipient details                                                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-501     | Transaction creation is rejected                                                | The transfer instruction has been rejected due to sender or recipient details                                                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-502     | Mismatch between transaction's wallet currency and field: *field\_name*         | The cryptocurrency you provided for the field is not consistent with the wallet used for the transaction                                                                                                                                             |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-503     | Value of the field: *field\_name*  is not adapted to this endpoint              | You provided a value that is not supported by the endpoint you used. Example: "preburn" while using the endpoint "/api/core/transactions"                                                                                                            |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-504     | Mismatch between field: *field1\_name* and field: *field2\_name*                | The fields "field1" and "field2" must have the same value                                                                                                                                                                                            |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-505     | Mismatch between transaction's wallet and field: *field\_name*                  | The value you provided for the field does not match the wallet used for the transaction                                                                                                                                                              |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-506     | Mismatch between transaction's company and field: *field\_name*                 | The value you provided does not match the company used for the transaction                                                                                                                                                                           |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-512     | Eth transaction fee-included not allowed                                        | You can't submit a transaction ETH included fees                                                                                                                                                                                                     |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-601     | Ledger wallet is not compatible with this operation                             | You are trying to initiate a contract-related transaction while using a wallet that does not support this operation                                                                                                                                  |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-604     | Error retrieving the wallet address                                             | Zodia was not able to retrieve the address associated to this wallet                                                                                                                                                                                 |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-615     | The sender and recipient cannot be the same                                     | The provided transfer sender and transfer recipient cannot be the same                                                                                                                                                                               |
| [401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401) | ER-210     | Signature verification failed                                                   | Zodia was not able to verify the signature you provided. Either because: private key that signed the data does not match with public key shared with ZodiaData signed is wrong Please refer to the section [Authentication](#section/Authentication) |
| [401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401) | ER-211     | Access to this resource is denied                                               | The entitlements defined by Zodia don’t allow you to access this resource                                                                                                                                                                            |
| [404](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404) |            | Endpoint doesn't exist                                                          | You are trying to reach an endpoint that does not exist                                                                                                                                                                                              |
| [405](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/405) | ER-204     | Available methods : *available\_methods*                                        | You must choose from the available methods for an endpoint. Example: GET,POST                                                                                                                                                                        |
| [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) | ER-208     | Rate limit or daily quota exceeded                                              | Too many request submitted in a given time period, exceeded the number of requests allowed                                                                                                                                                           |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-903     | Invalid parameter: filter                                                       | You must provide a valid filter value                                                                                                                                                                                                                |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-1123    | This user is already link to a group change : *value*                           | You must provide a different group for this user                                                                                                                                                                                                     |
| [401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401) | ER-1200    | Invalid company Id                                                              | The value you provided does not match the any valid company Id                                                                                                                                                                                       |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-1201    | Invalid notification Id                                                         | The value you provided does not match the any valid notification Id                                                                                                                                                                                  |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-1650    | Invalid entity ID                                                               | The value you provided does not match the any valid entity Id                                                                                                                                                                                        |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | ER-1902    | You need to deactivate all active addresses before deactivating the beneficiary | All active addresses must be deactivated first                                                                                                                                                                                                       |
| [500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) | ER-001     | Unexpected error: *error*                                                       | Zodia encountered an unexpected error and can not fulfill the request Please contact Zodia with the error's identifier beginning with the keyword "ERR"                                                                                              |
