Integrate Case Management Decisions

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": "sosha.mathew+watchlist@socure.com",
    "environment_name": "Production",
    "globalWatchlist": {
      "caseReviewStatus": "no match"
    }
  }
}

Sample webhook response with match

{
  "event_id": "88888888-8888-8888-8888-888888888888",
  "event_at": "2026-04-01T14:30:00.000Z",
  "event_type": "case_management_notification_case_closure",
  "data": {
    "id": "Effectiv-Test-combined-hits_abc123",
    "workflow": "individual_onboarding",
    "eval_id": "f1234567-abcd-4567-89ef-0123456789ab",
    "reviewer_id": "analyst@company.com",
    "environment_name": "Production",
    "globalWatchlist": {
      "caseReviewStatus": "match",
      "caseDetails": [
        {
          "entityId": "ZaP+/U4Q8ZQsYGxKZVMIsFKF",
          "entityReviewStatus": "match",
          "sourceList": [
            "OFAC SDN List",
            "United Nations Consolidated List",
            "PEP Data",
            "adverseMedia"
          ],
          "associatedCategories": [
            "Sanction",
            "Pep Class 1",
            "V2 Financial Aml Cft"
          ]
        },
        {
          "entityId": "XbQ+/V5RS2u/h4CiZFYstAd/6Q4GDlS",
          "entityReviewStatus": "match",
          "sourceList": [
            "adverseMedia"
          ],
          "associatedCategories": [
            "V2 Violence Aml Cft"
          ]
        }
      ]
    }
  },
  "watchlist_case_id": "combined-hits-case-001"
}