HTTP Status Codes

Understand Risk Modeler API status codes

The Risk Modeler API indicates the success or failure of an API request with an HTTP 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.

The Risk Modeler API 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.

CodeDefinition
200 OKAn OK status indicates that the request was successful.

In general, IRP APIs return a 200 OK response for all successful GET requests.
202 AcceptedThe 202 (Accepted) status code indicates that the request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon, as it might be disallowed when processing actually takes place. There is no facility in HTTP for re-sending a status code from an asynchronous operation.

Risk Modeler API returns a 202 Accepted response when it initiates a workflow job.
204 No ContentThe No Content status code indicates that the server has successfully fulfilled the request and that there is no additional content to send in the response content. Metadata in the response header fields refer to the target resource and its selected representation after the requested action was applied.

The Intelligent Risk Platform returns a 204 No Content response when it receiveds a DELETE request.
400 Bad RequestThe 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).

These error are generally accompanied by an error message that is returned in the header of the response. To learn more, see Error Codes.
401 UnauthorizedThe Unauthorized status indicates that the credentials are missing or invalid.
403 ForbiddenThe Forbidden status indicates that Cannot access: Access Control, Licensing or Rate Limiting.
500 Internal Server ErrorThe Internal Server Error status code indicates that the server could not fulfill the request due to an unexpected condition.