HTTPS Status & Error Codes

This page provides a reference for all HTTP status codes and error codes returned by the API.

2xx Success Codes

Successful requests return a 2xx status code.

Code	Name	Description
200	OK	The request was successful and the response contains the requested data.
201	Created	The request was successful and a new resource has been created as a result.
202	Accepted	The request has been accepted for processing, but the processing has not been completed.
204	No Content	The request was successful but there is no content to return.

Redirection codes indicate that further action is needed to complete the request.

Code	Name	Description
301	Moved Permanently	The resource has been permanently moved to a new URL.
302	Found	The resource has been temporarily moved to a different URL.
304	Not Modified	The resource has not been modified since the last request.
307	Temporary Redirect	The request should be repeated with a different URL, but future requests should still use the original URL.

Client error codes indicate that there was a problem with the request.

Code	Name	Description
400	Bad Request	The request is invalid or malformed. Check your request syntax and parameters.
401	Unauthorized	Authentication is required or has failed. Verify your API key or access token.
403	Forbidden	The authenticated user does not have permission to access this resource.
404	Not Found	The requested resource does not exist.
405	Method Not Allowed	The HTTP method used is not supported for this resource.
409	Conflict	The request conflicts with the current state of the resource.
422	Unprocessable Entity	The request is well-formed but contains semantic errors.
429	Too Many Requests	Rate limit exceeded. The client has sent too many requests in a given time period.

Server error codes indicate that the server encountered an error while processing the request.

Code	Name	Description
500	Internal Server Error	An unexpected error occurred on the server.
502	Bad Gateway	The server received an invalid response from an upstream server.
503	Service Unavailable	The server is temporarily unable to handle the request.
504	Gateway Timeout	The upstream server failed to respond within the required time.

Error Code	HTTP Status	Description
`INVALID_REQUEST`	400	The request is missing required parameters or contains invalid values.
`INVALID_API_KEY`	401	The provided API key is invalid or has expired.
`AUTHENTICATION_FAILED`	401	Authentication failed. Verify your credentials.
`INSUFFICIENT_PERMISSIONS`	403	Your API key or access token does not have the required permissions.
`RESOURCE_NOT_FOUND`	404	The requested resource does not exist.
`DUPLICATE_RESOURCE`	409	A resource with the same identifier already exists.
`INVALID_STATE_TRANSITION`	409	The requested operation cannot be performed in the current resource state.
`VALIDATION_ERROR`	422	The request contains validation errors. Check the details for field-specific information.
`RATE_LIMIT_EXCEEDED`	429	Too many requests have been made. Wait before retrying.
`INTERNAL_ERROR`	500	An unexpected error occurred on the server.
`SERVICE_UNAVAILABLE`	503	The service is temporarily unavailable. Please try again later.