Return codes

We use the Internet standard HTTP return codes.

20X SUCCESS
40X Error in the request
5xx Server error - please report these to us

The most common error to receive when sending a transaction is "insufficient funds". This error comes with a free HTTP return code of 403. This error is returned when the transaction cannot be completed because the account it relates to does not have a line of credit large enough to authorise the transaction.

Here are all the most frequently seen errors:

HTTP Code	Description	Example
400	Bad request	The request payload contained an error
401	Not authorised	The API key was missing or incorrect
403	Forbidden	Transaction rejected eg due to insufficient funds
404	Not found	Path was incorrect or the resource could not be found eg the resource id was incorrect
405	Method not allowed	Each endpoint is restricted to a single verb, so this can be returned if a different verb is used

🗒️
For other API error response codes, you can refer to the API error response codes list located here.