The Bitpowr API uses standard HTTP response codes. Any response code with a 2xx status indicates the request succeeded. However, a response code in the 4xx range indicates an error with the data provided.

When your application encounters a 4xx error, it's essential to handle it programmatically. You can do this by referring to the error description.

On the other hand, if you receive a 5xx error, it means we have encountered an error in our software, which we will work to fix immediately.

A table of status codes and their meanings can be found below.

2xx Success

Status Code	Description
200 OK	The request succeeded.
201 Created	The request succeeded, and the new resource was created.
202 Accepted	The request has been accepted for processing, but the processing still needs to be completed.

4xx Client Errors

Status Code	Description
401 Unauthorized	The API key was invalid.
403 Forbidden	The account does not have access to the requested resource, or the request is blocked for security reasons.
404 Not Found	The resource that was requested could not be found.
409 Conflict	The request conflicts with another request.
413 Payload Too Large	The request exceeds the maximum supported size (25 MB).
422 Unprocessable Entity	Data was invalid or missing the required parameters.
429 Too Many Requests	The account has issued too many requests.

5xx Server Errors

Status Code	Description
500 Internal Server Error	Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
502 Bad Gateway	Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
503 Service Unavailable	Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
504 Gateway Timeout	Our server encountered an error while processing your request. We will be notified and work on a fix immediately.