The following table lists some common HTTP status codes which you may encounter when using our API calls. Refer to the information for guidance when you encounter an unfamiliar error. Please handle all 4xx error codes as client browser error responses and 5xx error codes as server error responses.
Please do note that there are other 4xx and 5xx status codes which should be managed as exceptions.
200 – OK
The request was successfully processed.
201 – Created
The request successfully created a new entry (for example: a user, item, or bank account).
400 – Bad Request
The request contained invalid information. Example: a malformed URL or missing required path parameters.
401 – Unauthorized
The request could not be processed due to missing or invalid authentication credentials.
403 – Forbidden
The request could not be completed due to access restrictions. See the API response for further details.
404 – Not Found
The requested information could not be found. Ensure that you have entered the correct details in your request.
408 – Request Timeout
The request took too long to reach our servers. Please check your internet connection and try again.
409 – Conflict
The request could not be processed because it conflicts with the current state of the entity. Example: a virtual account already exists for a wallet and another creation attempt was made.
422 – Unprocessable Entity
The request could not be processed because some fields require correction or input. See the API response for details.
424 – Failed Dependency
An error occurred while processing your request. Please contact support and provide this reference: [correlation-id].
500 – Internal Server Error
An unexpected error occurred on our server.
502 – Bad Gateway
A communication issue occurred between servers. Please try again in a few minutes.
503 – Service Unavailable
Our servers are temporarily down or unable to process your request. See our Status page for updates.
504 – Gateway Timeout
The request took too long to be processed between servers. Please try again after a few minutes or check our Status page for updates.
515 – Service Temporarily Unavailable
We are unable to process your request at this time. Please try again later.
516 – Service Unavailable
We encountered an error with our provider. Reference: [correlation-id]. Please contact our support team for assistance.