HTTP errors

The Draft & Goal API uses standard HTTP error codes to indicate the success or failure of requests.

  • 400 Bad Request : The request was malformed or invalid.
  • 401 Unauthorized : The request was not authorized. There’s an issue with the API key.
  • 403 Forbidden : The request is forbidden. The API key does not have access to the resource.
  • 404 Not Found : The requested resource was not found.
  • 422 Unprocessable Entity : The request was valid but the server could not process it.
  • 429 Too Many Requests : The request was rate limited.
  • 500 Internal Server Error : An error occurred on the server.

Error shapes

The Draft & Goal API returns error shapes in the response body for all error responses.

{
    "type": "error",
    "message": "The request was malformed or invalid."
}