HTTP Status Codes

The Platform APIs indicate 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.

IRP 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.
201 CreatedThe Created status code indicates that the request has been accepted for processing, and that the platform will initiate a job to process the request. HTTP cannot resend status code from an asynchronous operation. Created status indicates that the entity requested has been created successfully.

Intelligent Risk Platform returns a 201 Created 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).

Indicates a validation error or that the request parameters were incorrect.
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.
405 Method Not AllowedThe Method Not Allowed status indicates that principal is not authorized to make the request. For more information, see Access Control
500 Internal Server ErrorThe Internal Server Error status code indicates that the server could not fulfill the request due to an unexpected condition. `