Our APIs support the following HTTP response codes to indicate the success or failure of an API request.
| Status Code | Description |
|---|
| 200 - OK | The request was successful |
| Status Code | Description |
|---|
| 301 - Moved Permanently | The URL of the requested resource has been changed permanently. The new URL is given in the response. |
| 302 - Temporary Redirect | This is used to indicate that the URI of the resource has been changed temporarily. |
| 304 - Not Modified | This is used for caching purposes to indicate that the content has not been modified, so the client can use the same cached version of the response instead of reingesting the full payload. |
| Status Code | Description |
|---|
| 400 - Bad Request | A variable in the request is incorrect, check the reply message for details |
| 401 - Unauthorized | The request was not successful because it lacked valid authentication credentials for the requested resource. |
| 403 - Forbidden | The request is legitimate but proper authorization was not provided. |
| 404 - Not Found | The requested resource was not found. |
| 404 - Not Found | Invalid route |
| 404 - Not Found | Wrong identifier |
| 405 - Method Not Allowed | The HTTP request method is known by the server but not supported by the target resource. |
| 408 - Request Timeout | This response is sent on an idle connection by some servers, even without any previous request by the client. It means that the server would like to shut down this unused connection. This response is used much more since some browsers use HTTP pre-connection mechanisms to speed up browsing. Some servers may shut down a connection without sending this message. |
| 410 - Gone | This response is sent when the requested content has been permanently deleted from the server, with no forwarding address. Clients are expected to remove their caches and links to the resource. |
| 429 - Quota Exceeded | The number of sent requests to this product has exceeded the amount allowed for its usage plan. |
| 429 - Throttled | The number of sent requests to this product has exceeded the maximum allowed in a given time period (usually 1 second). |
| 499 - Client Closed the Request | The connection was closed by the client before the full request could be returned. |
| Status Code | Description |
|---|
| 500 - Internal Server Error | The server encountered an unexpected condition, which prevented it from fulfilling the request or serving the response. |
| 502 - Bad Gateway | This indicates that a server was acting as a gateway or proxy and that it received an invalid response from the upstream server. If the problem persists, please get in touch with support. |
| 503 - Service Unavailable | The server was unable to retrieve the request due to a technical issue or scheduled maintenance. |
| 504 - Gateway Timeout | The server did not receive a timely response from another server upstream. |
