The HTTP response code tells your application whether the API could process your request.
The codes are grouped into ranges. For a simple error handling strategy it's often sufficient to only test the first character.
- 200-299: Success. The server has done what the client requested.
- 400-499: Client Errors. Generally the client must ammend the request.
- 500-599: Server Errors. The server has a problem that is not related to the request.
Success Codes (2xx)
| HTTP Status Code |
Error Message |
Description |
| 200 |
OK |
The API was able to do what you asked. |
Client Errors (4xx)
| HTTP Status Code |
Error Message |
Description |
| 400 |
Bad Request |
The API could not understand your request. |
| 401 |
Unauthorized |
The access token was missing or invalid. |
| 403 |
Forbidden |
You have not been granted permission to access the requested method or object. |
| 403 |
Not Authorized |
The API key associated with your request was not recognized or the signature was incorrect. |
| 403 |
Account Inactive |
The API key you are using has not been approved or has been disabled. |
| 403 |
Account Over Queries Per Second Limit |
You have made too many calls per second with this API key. |
| 403 |
Account Over Rate Limit |
You have exceeded the rate limit for this API key. |
| 403 |
Rate Limit Exceeded |
The service you have requested is over-capacity. |
| 404 |
Not Found |
The API does not have the resource that you asked for. |
| 405 |
Not Allowed |
You have used a method (e.g. PUT) that isn’t supported for this resource. |
Server Errors (5xx)
| HTTP Status Code |
Error Message |
Description |
| 500 |
Internal Server Error |
Something has gone terribly wrong, but it's not your fault. Try again later. |