📛 Error Codes
The most common error codes when using our APIs are standard HTTP protocol codes.
In brief
- HTTP status codes in the 2XX range indicate a successful request.
- Codes in the 3XX range indicate a redirection of the requested resource.
- Codes in the 4XX range represent client-side errors related to the data sent in the request, such as missing required parameters, incorrect headers, or invalid authentication credentials.
- Codes in the 5XX range indicate major errors that occurred on the server.
HTTP Codes
The most frequently used HTTP codes and their meanings are:
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request was successful |
| 201 | Created | The request was successful, and a resource was created as a result |
| 202 | Accepted | Request has been accepted and acknowledged. We will now go ahead to process the request and notify you of the status afterwards |
| 401 | Unauthorized | Missing required headers, wrong Public or Secret Key, etc. |
| 403 | Forbidden | You are trying to access a resource for which you don't have proper access rights |
| 404 | Not Found | You are trying to access a resource that does not exist |
| 422 | Unprocessable Entity | Malformed request or missing required parameters |
| 429 | Too Many Requests | You have exceeded the number of requests allowed in a given time frame |
| 500 | Internal Server Error | We had a glitch in our servers. Retry the request in a little while or contact support. Rarely happens. |
| 503 | Service Unavailable | We are temporarily offline for maintenance. Please try again later. Rarely happens. |