REST API return codes

The REST API supports the following HTTP response codes to indicate the request status.

Numeric Code Message Description
200 OK The request was successful.
240 No Content The request was successful, but there is no content to return.
400 Bad Request The request did not contain all required input, had malformed syntax, or the included input failed validation.
401 Unauthorized The user does not have valid authentication credentials to access the requested resource.
403 Forbidden The user does not have access to this endpoint or the entity for which they made the call; or the endpoint or entity does not exist.
404 Not Found The requested resource has not been found.
409 Conflict The request conflicts with the current state of the server.
410 Gone The request uses a deprecated endpoint or property.
429 Too Many Requests The number of sent requests to the endpoint has exceeded the rate limit.
500 Internal Server Error The server encountered an unexpected condition, which prevented it from fulfilling the request or serving the response.
503 Service Unavailable The server was unable to handle the request due to a temporary overload. Use the 'Retry-After' header as guidance on when to retry your request.

See also the HTTP status codes RFC.