Error codes
This page describes error codes for API version 2024-06-30 or later. For older API versions, please see Error codes (legacy API versions).
This page lists all the possible errors associated with the HTTP 400 status code while creating/managing conversions and conversion amendments via our API endpoints.
For 400 errors, the response you receive will contain a code specifying the error encountered, message about the error, and source providing additional context about the error.
General errors with example response
A general error provides an error response with code, message, source. Like in the example below, the response contains an errors object with:
code: Unique numeric identifier of the specific validation error encountered.message: A message about the specific error encountered.source: The specific field or object within the request that has failed.details: Additional details about the request. Generally includes error code trace ID (correlation_id) for Airwallex debugging.
Example:
Example with details:
See below for all potential error codes and descriptions, organized by corresponding Conversion API & Conversion Amendments API endpoints.
Conversion errors
Error codes and detailed descriptions for Create a new conversion API, Retrieve a conversion API and List all conversions API.
| Code | Description | Next steps |
|---|---|---|
amount_above_limit | The amount requested exceeds the maximum conversion limit. Default is $5,000,000 USD. | Lower the conversion amount or speak to you account manager to change your limits. |
amount_below_limit | The amount requested falls below the minimum conversion limit. Default is $1 USD. | Increase the conversion amount or speak to you account manager to change your limits. |
field_required | A mandatory field in the request is missing. | See the message and source code in the response. |
invalid_conversion_date | The conversion creation request failed as the conversion_date is invalid. Default supported value date is T+2. | You can convert 24/7/365. The date must be a valid date (YYYY-MM-DD) in the future, up to your supported value date. |
invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. |
term_agreement_is_required | You must agree to Airwallex's Terms and Conditions to create a conversion. | term_agreement must be set to true |
unsupported_currency | The buy or sell currency is invalid. | Must be a three-letter ISO 4217 currency code. See supported currencies. |
invalid_quote_id | The request failed. | Use a valid quote_id or speak to your account manager. |
expired_quote | The quote is expired. | Use a valid quote_id or speak to your account manager. |
conflict_original_ccy | The quote currencies differ from the currencies in the create conversion request. | Must be a three-letter ISO 4217 currency code. See supported currencies. |
operation_failed | The request failed. | Contact support or speak to your account manager. |
not_found | The conversion was not found for the request. | Use a valid conversion_id or speak to your account manager. |
insufficient_funds | Insufficient funds in sell_currency to execute conversion. | Lower the conversion amount or add funds to your sell_currency wallet . |
credit_limit_exceeded | You have exceeded the upper limit of unfunded transactions you can have open with Airwallex at any one time. | Lower the conversion amount, settled unfunded transactions or speak to your account manager to increase your limit. See Funding and Settlement Models for more information. |
incorrect_version | The version is incorrect for endpoint. | Ask your account manager to change your API version or use x-api-version in the header. |
Rates and Quotes errors
Error codes and detailed descriptions for Create a quote API and Retrieve a current rate API.
| Code | Description | Next steps |
|---|---|---|
incorrect_version | The version is incorrect for endpoint. | Ask your account manager to change your API version or use x-api-version in the header. |
validation_error | The amount requested falls below the minimum conversion limit. Default is $1 USD. | See the message and source code in the response. |
field_required | A mandatory field in the request is missing. | See the message and source code in the response. |
invalid_conversion_date | The conversion creation request failed as the conversion_date is invalid. Default supported value date is T+2. | You can convert 24/7/365. The date must be a valid date (YYYY-MM-DD) in the future, up to your supported value date. |
invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code in the response. |
invalid_parameter | The buy or sell currency is invalid. | Must be a three-letter ISO 4217 currency code. See supported currencies. |
Conversion amendments errors
Error codes and detailed descriptions for Create an amendment quote API, Create an amendment API, Retrieve an amendment API and List all amendments API.
| Code | Description | Next steps |
|---|---|---|
account_not_authorized | The account is not authorised to amend conversions. | Only post-fund and pre-fund accounts can amend conversions See Conversion Amendments for more information. |
does_not_exist | The conversion does not exist. | Provide a valid conversion_id. |
field_required | A mandatory field in the request is missing. | See the message and source code in the response. |
invalid_status_for_operation | The conversion is in a state that cannot be amended. | Only conversions in SCHEDULED and OVERDUE can be cancelled. See Conversion Statuses for more information. |
invalid_charge_currency | The charge_currency is neither buy currency nor sell currency. | Only the currencies from the original conversion are allowed. Must be a three-letter ISO 4217 currency code. |
invalid_argument | A provided argument has an incorrect type or failed a validation test. | See the message and source code. |