HTTP Status Codes

The Climate On Demand API indicates the success or failure of an API request with a status code. These status codes are displayed in the message body of the HTTP response.

HTTP response status codes enable you to verify normal behavior and provide context for understanding exceptions.

Climate on Demand uses standard HTTP response codes to indicate the success or failure of an API request. The table summarizes the significance of these response codes and links to documentation in RFC 9110.

Code	Definition
200 OK	An `OK` status indicates that the request was successful. In general, the Climate on Demand API returns a `200 OK` response for all successful requests.
400 Bad Request	The `Bad Request` status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).` Indicates a validation error or that the request parameters were incorrect.
401 Unauthorized	The `Unauthorized` status indicates that the credentials are missing or invalid, e.g no valid API key was provided.
403 Forbidden	The `Forbidden` status indicates that access to the resource is denied or unauthorized.
404 Not Found	The `Not Found` status indicates that the resource was not found.
405 Method Not Allowed	The `Method Not Allowed` status indicates that the requested action is not allowed.
500 Internal Server Error	The `Internal Server Error` status code indicates that the server could not fulfill the request due to an unexpected condition. `