Depending on the endpoint, you could get different error responses. Some might be just informational (for example, a 409 http status code is return for entities already received, which you can use to avoid replays)
All error messages have the following structure
{
"error_code": "expired_order",
"error_msg": "The order has expired and cannot be confirmed"
}
| Error Code | Description | HTTP Status |
|---|---|---|
| auth_required | HTTP Authorization failed for the request | 401 |
| body_parse_error | The body of the request is an invalid JSON or has invalid/missing required fields | 400 |
| conflict | The entity you tried to create already exists | 409 |
| destination_unable_to_receive | The destination is unable to receive. Either because the account is blocked or simply does not have the product required. | 400 |
| expired_order | The order has expired and cannot be confirmed | 400 |
| full_amount_required | The remainder of investment tokens value after the redemptions is below the minimum allowed. Use the full_amount parameter instead to obtain the desired amount plus the remainder | 400 |
| insufficient_funds | There are not enough funds to complete the order | 400 |
| internal_error | Unexpected Internal Server occurred | 500 |
| invalid_crypto_currency_address | The crypto currency address provided is not valid | 400 |
| invalid_destination | The destination value provided is not valid for the operation | 400 |
| invalid_order_state | The order is in a different state than required to process the request | 400 |
| invalid_parameters | There are missing or invalid parameters in the request. This is a general Bad Request error. | 400 |
| invalid_quote | The quote id provided cannot be used to create the order | 400 |
| invalid_reference_id | The order reference id differs from the provided reference id | 400 |
| invalid_security_code | The security code provided for confirmation is not valid. | 400 |
| invalid_settlement_currency | The settlement currency provided is not valid for the operation | 400 |
| method_not_allowed | HTTP Method not allowed | 405 |
| not_found | Resource not found | 404 |
| operation_forbidden | The operation requested is forbidden | 403 |
| operation_forbidden_for_customer | The customer is not allowed to execute the operation. | 403 |
| quote_amount_too_small | Cannot generate a buy/sell quote, the resulting amount is too small. | 400 |
| quote_not_found | Quote not found for the provided quote id | 400 |
| reference_id_already_exists | An order already exists with the provided reference id | 400 |
| settlement_required | Settlement currency parameter is required for this operation | 400 |
| too_many_invalid_codes | Too many attempts to confirm the order with an invalid code. The order is cancelled. | 400 |
Note
Descriptions listed here are approximate, you should read the
err_msgproperty in the response body for the actual error reason for the sent request