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. |