Integrate Case Management Decisions

Get alerts when your compliance team closes cases with a Decision

Case management webhook events

When a member of your compliance team closes a case in the RiskOS™ Dashboard—either as a match or no match—you’ll receive a webhook notification containing the case details, including the review status of each entity.

`case_management_notification_case_closure`

Webhook response fields

Field Name	Type	Always Present	Explanation
`event_id`	String	Yes	Unique identifier for this webhook event. Useful for deduplication or tracing.
`event_at`	String (ISO 8601 datetime)	Yes	Timestamp when the case closure event was created.
`event_type`	String	Yes	Type of event. For this webhook, it will always be `case_management_notification_case_closure`.
`data.id`	String	No	Your internal ID you passed when creating the original screening evaluation request .
`data.workflow`	String	Yes	Workflow associated with the case (e.g., `consumer_onboarding`).
`data.eval_id`	String	Yes	Evaluation ID generated in the original screening evaluation response
`data.reviewer_id`	String (email)	Yes	Email of the reviewer or system account that performed the case closure.
`data.environment_name`	String	Yes	Indicates whether the webhook originated from `Production` or `Sandbox`.
`data.globalWatchlist.caseReviewStatus`	String	Yes	Final case review status — either `match` or `no match`.
`data.globalWatchlist.caseDetails[n].entityId`	String	Yes	Unique identifier for each matched entity found on a list.
`data.globalWatchlist.caseDetails[n].entityReviewStatus`	String	Yes	Indicates whether the individual entity was reviewed as a `match` or `no match`.
`data.globalWatchlist.caseDetails[n].sourceList[]`	Array of Strings	Yes	Lists the data sources where the entity was matched (e.g., “Mexico Michoacan Municipalities Leadership”).
`data.globalWatchlist.caseDetails[n].associatedCategories[]`	Array of Strings	Yes	Lists associated categories or classifications for the entity (e.g., “Pep Class 4”).

Sample webhook response with no match

{
  "event_id": "91150283-fd64-4786-9e56-af96e9c8fef2",
  "event_at": "2025-08-22T20:07:15.820Z",
  "event_type": "case_management_notification_case_closure",
  "data": {
    "id": "",
    "workflow": "consumer_onboarding",
    "eval_id": "63c22805-6462-445c-b48d-dfca656baaa9",
    "reviewer_id": "[email protected]",
    "environment_name": "Production",
    "globalWatchlist": {
      "caseReviewStatus": "no match"
    }
  }
}

Sample webhook response with match

The case_closure event response will vary depending on your dispositioning configuration:

Dispositioning per matched entity
Dispositioning per source within a matched entity

{
"event_id": "557a2863-5442-4bbb-9d1e-92c1205d0a80",
"event_at": "2025-10-28T22:45:01.981Z",
"event_type": "case_management_notification_case_closure",
"data": {
"id": "",
"workflow": "consumer_onboarding",
"eval_id": "8c41de39-7b1e-4e6f-bcea-dd4275b8d41b",
"reviewer_id": "[email protected]",
"environment_name": "Production",
"globalWatchlist": {
  "caseReviewStatus": "match",
  "caseDetails": [
    {
      "entityId": "ZaP+/U4QRtJWbWtWCFNq2FSCgZKVC0w",
      "entityReviewStatus": "match",
      "sourceList": [
        "Mexico Michoacan Municipalities Leadership"
      ],
      "associatedCategories": [
        "Pep Class 4"
      ]
    }
  ]
}
}
}

Updated 3 months ago