Moneroo API is RESTful and as such, uses conventional HTTP response codes to indicate the success or failure of requests. This section describes the summary of these codes and what they mean in our context.


  • Codes in the 2XX range mean that the API request was processed successfully.

  • Codes in the 4XX range mean that something was wrong with the data that you sent. For example, you might have missed some required parameters/headers, or you might be using the wrong API credentials.

  • Codes in the 5XX range indicate an error in processing on our end

Common HTTP Codes



OK - Request was successful


Created - The request was successful, and a resource was created as a result


Accepted - Request has been accepted and acknowledged. We will now go ahead to process the request and notify you of the status afterwards.


Bad Request - Malformed request or missing required parameters


Unauthorized - Missing required headers, wrong Public or Secret Key etc


Forbidden - You are trying to access a resource for which you don't have proper access rights.


Not Found - You are trying to access a resource that does not exist


Unprocessable Entity - You provided all the required parameters but they are not proper for the request


Too Many Requests - You have exceeded the number of requests allowed in a given time frame.


Internal Server Error - We had a glitch in our servers. Retry the request in a little while or contact support. Rarely happens.


Service Unavailable – We are temporarily offline for maintenance. Please try again later. Rarely happens.

Last updated