HTTP Error codes

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.

StatusDescription
200 OKThe request was successfully processed.
201 CreatedThe request successfully created an entry (which could be a user, item, bank account, etc.)
400 Bad RequestSome invalid information is passed in the request. Example - URL is malformed (missing the needed path params)
401 UnauthorizedThe request could not be processed due to missing or invalid authentication credentials
403 ForbiddenThe request could not be granted due to access restrictions. See the API response for guidance.
404 Not FoundThe information requested was not found. Ensure that you have entered the correct details for your request.
408 Request TimeoutThe request took too long to be sent from your client to our servers. Please check your internet connection before you try again.
409 ConflictThe request cannot be processed as it conflicts with the current state of entity (example - virtual account already exists for a wallet and an attempt is made to create a new one again for the same wallet).
422 Unprocessable EntityThe request could not be processed because some fields require your input or correction. See the API response for guidance.
424 Failed DependencyAn error occurred processing your request. Please contact support providing this reference: {correlation ID}
500 Internal Server ErrorAn unexpected error was encountered.
502 Bad GatewayThere is a problem communicating between servers. Please try again after a few minutes.
503 Service UnavailableOur servers are currently down or unable to process your request. See our Status page for updates.
504 Gateway TimeoutThe request took too long to be sent between servers. Please try again after a few minutes or see our Status page for updates.
515 Service Temporarily UnavailableWe are unable to process your request at the moment, please try again later.
516 Service UnavailableWe encountered an error with our provider [correlation-id]. Please contact our support team.

🚧

Continue to receive errors?

If you continue to receive the above errors and require assistance to diagnose, please contact our support team at mailto:[email protected]