HTTP status codes do not always provide sufficient information about the cause of an error. For more detailed programmatic handling of errors, responses contain additional JSON fields that describe the error.
## Error format
Whenever an API request results in an error, the response will contain both a high-level error class specified by the `code` and a human-readable summary in the `message`.
## Extended error format
In some cases there is extended information available for clients about why a request has failed. For example, failing to supply a value for a required **field1** will result in the following error:
## List of API Error Codes
The table below shows the list of error codes that may be returned in an API error response.
| Code | Message | Description |
| -1 | Unknown Error | An unknown error occurred processing the API request |
| 1 | Malformed authorization. Is the authorization type missing? | API Key is missing or malformed |
| 2 | Invalid Entity | Error with the JSON object passed in the request body |
| 3 | Forbidden | API Key used with request does not have one of the roles authorized to call the API endpoint |
| 1032 | Account number is invalid or missing | An invalid number was provided when creating a card |
| 1051 | Payment not found | The payment id requested was not found |
| 1068 | Merchant account not associated with a marketplace | Attempting to create a marketplace payment with a merchant that is not associated with the marketplace |
| 1069 | A wallet account could not be found | Unable to find the wallet account referenced in a marketplace create payment request |
| 1070 | Marketplace info is required to create marketplace payment | Marketplace info was not provided with a marketplace create payment request |
| 1076 | Payment amount did not fall within merchant charge limits | The payment amount was greater than the maximum allowed limit or below the minimum allowed limit |
| 1077 | Payment amount is invalid | Payment amount must be greater than zero |
| 1078 | Payment currency not supported | An invalid currency value was used when making a payment |
| 1083 | Idempotency key already bound to other request | The idempotency key used when making a request was used with another payment. Please retry with a different value |
| 1084 | This item cannot be canceled | A cancel or refund request cannot be canceled |
| 1085 | This item cannot be refunded | A cancel or refund request cannot be refunded |
| 1086 | This payment was already canceled | This payment was already canceled |
| 1087 | Total amount to be refunded exceeds payment amount | Total amount to be refunded exceeds payment amount |
| 1088 | Invalid source account | An invalid source account was specified in a payout or transfer request |
| 1089 | The source account could not be found | Unable to find the source account specified in a payout or transfer request |
| 1091 | Invalid wire routing number | Could not find a bank with that routing number when creating wire bank account |
| 1092 | Invalid IBAN | Invalid IBAN used in request to create a wire bank account |
| 1093 | Source account has insufficient funds | The source account has insufficient funds for the payout or transfer amount |
| 1094 | The billing last name cannot be empty | When creating a card or bank account the billing last name must be provided |
| 1096 | Encryption key id could not be found | An encryption key id must be provided if request includes encrypted data |
| 1097 | Original payment is failed | Attempting to cancel or refund a failed payment |
| 1098 | Wire payment amount failed | Wire payment must be greater than the minimum amount |
| 1099 | The merchantWalletId query parameter is missing | The merchantWalletId query parameter must be set in association with the walletId parameter to retrieve wallet settlements |
| 1100 | Invalid fiat account type | The fiat account is invalid for the attempted payout type (e.g. using a business account for a marketplace payout) |
| 1101 | Invalid country format | An invalid ISO 31660-2 country code was provided |
| 1102 | IBAN country mismatch | IBAN does not match the provided bank country code |
| 1103 | IBAN required | IBAN is required is this request |
| 1104 | Additional bank details required | There are additional bank details required for this request; details of which are provided in the response |
| 1105 | Additional billing details required | There are additional billing details required for this request; details of which are provided in the response |
| 1106 | Invalid district format | Invalid district format, must be a 2 character value |
| 1107 | Payout limit exceeded | Payout can't be accepted as it would exceed the given limit |
| 1108 | Unsupported Country | Country not supported for customer |
| 1109 | Invalid bin range | No bin range found for the card |
| 1110 | Invalid card number | Card number is invalid |
| 1111 | Invalid issuer country | Issuer country is invalid |
| 1143 | Checkout session not found | The checkout session id passed in the request doesn't exist in the DB |
| 1144 | Checkout session is already in a completed state | The checkout session cannot be extended because it is already in a complete state |
| 2003 | The recipient address already exists | The blockchain address has already been associated with the account |
| 2004 | The address is not a verified withdrawal address | The blockchain address must first be verified before it can be used as a destination in a transfer request |
| 2005 | The address belongs to an unsupported blockchain | The blockchain type used as a transfer destination is not supported |
| 2006 | Wallet type is not supported | The wallet type specified when creating an end user wallet is not supported |
| 2007 | Unsupported transfer | A transfer from the provided source to the provided destination is not supported |
| 5000 | Invalid travel rule identity type | The provided identity type must be either "individual" or "business" |
| 5001 | Payout does not found | Payout doesn’t exist based on the ID provided. Please check the payout id |
| 5002 | Invalid payout amount | Payout amount must be more than 0 |
| 5003 | Inactive destination address | Cannot send payout to an inactive destination address. If you have just added the address, you may have to wait for 24 hours before use |
| 5004 | Destination address not found | The destination address for this payout could not be found |
| 5005 | Source wallet not found | Source wallet for this payout could not be found |
| 5006 | Insufficient funds | The source wallet has insufficient funds for this payout |
| 5007 | Unsupported currency | currency not currently supported for this operation |
| 5011 | Invalid destination address | cannot send payout to an invalid destination address |
| 5012 | Invalid destination location types | cannot search for both crypto and fiat payouts |
| 5013 | Invalid source wallet id | source wallet id must be a number for payouts search |
| 5014 | The address is not valid for the blockchain | Provided blockchain address is not valid for the corresponding blockchain |
| 5015 | Invalid destination chain | Provided blockchain address has an invalid chain in respect to the currency used |