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”).

Associated Categories

Source Type	Associated Categories
Sanctions	Sanction
Enforcement	Warning Fitness Probity
PEP	Pep Class 1 Pep Class 1 - RCA Pep Class 2 Pep Class 2 - RCA Pep Class 3 Pep Class 3 - RCA Pep Class 4 Pep Class 4 - RCA
Adverse Media	V2 Other Minor V2 Other Serious V2 Property V2 Fraud Linked V2 Narcotics Aml Cft V2 Violence Aml Cft V2 Violence Non Aml Cft V2 Terrorism V2 Cybercrime V2 Financial Aml Cft V2 Other Financial V2 Regulatory V2 General Aml Cft

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": "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": "[email protected]",
        "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"
    }

    {
      "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": "[email protected]",
        "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"
              ],
              "sourceLevelReview": [
                {
                  "sourceName": "OFAC SDN List",
                  "status": "match",
                  "category": "Sanction"
                },
                {
                  "sourceName": "United Nations Consolidated List",
                  "status": "not dispositioned",
                  "category": "Sanction"
                },
                {
                  "sourceName": "PEP Data",
                  "status": "match",
                  "category": "Pep Class 1"
                },
                {
                  "sourceName": "adverseMedia",
                  "status": "match",
                  "category": "V2 Financial Aml Cft"
                }
              ]
            },
            {
              "entityId": "XbQ+/V5RS2u/h4CiZFYstAd/6Q4GDlS",
              "entityReviewStatus": "no match",
              "sourceList": [
                "adverseMedia"
              ],
              "associatedCategories": [
                "V2 Violence Aml Cft"
              ],
              "sourceLevelReview": [
                {
                  "sourceName": "adverseMedia",
                  "status": "no match",
                  "category": "V2 Violence Aml Cft"
                }
              ]
            }
          ]
        }
      },
      "watchlist_case_id": "combined-hits-case-001"
    }

Updated 3 months ago

Did this page help you?