Webhook Response

When TruRisk (AI Compliance) screening is performed on a search, the AI Agent evaluates each result and assigns a compliance verdict. Whenever this verdict changes for one or more results in a search — for example, once the AI completes its initial evaluation, or reclassifies a result during a later re-screening — AML Watcher delivers a compliance_ai_status_change event to the webhook endpoint registered for your organization.

Sample Response
{
  "error": "False",
  "status": "SUCCESS",
  "event": "compliance_ai_status_change",
  "data": {
    "search_reference": "Your Search Reference",
    "client_reference": "Your Client Reference ID",
    "data": [
      {
        "record_id": "Record ID",
        "ai_confidence": 0.91,
        "ai_evaluation": "The AI has determined this is a True Positive match. The searched name, date of birth, and nationality align closely with the profiled record, and no distinguishing attributes contradict the match.",
        "ai_status": "potential_match"
      }
    ],
    "case_summary": {
      "true_positive_count": 0,
      "potential_match_count": 1,
      "uncertain_count": 0,
      "false_positive_count": 0,
      "true_negative_count": 0,
      "narrative": "TruRisk screening completed with no significant matches identified. No further action is required. However, the search was conducted against Adverse Media, PEP databases only. For comprehensive risk coverage, consider also screening against Fitness and Probity, Insolvency, Regulatory, Sanctions, SIE, SIP.",
      "recommendation": "No Further Action Required",
      "entity_id": null
    }
  }
}

Response

Parameter	Description
`error`	Whenever there is an error in delivering the notification, this field will have details of that error; otherwise it remains `"False"`.
`status`	The status of the webhook notification, either `"SUCCESS"` or `"FAIL"`.
`event`	The event type for this webhook notification. Always `compliance_ai_status_change` for TruRisk verdict updates.
`data.search_reference`	The reference of the search this update belongs to.
`data.client_reference`	The client reference supplied for the original search, if any.
`data.data`	An array of results whose AI compliance verdict changed.
`data.data[].record_id`	The unique identifier of the result whose verdict changed.
`data.data[].ai_confidence`	A numeric confidence score (0-1) for the AI's classification of this match.
`data.data[].ai_evaluation`	A human-readable explanation of why the AI classified this match the way it did.
`data.data[].ai_status`	The AI's updated classification of the match. See Enumerations & Reference for the full list of possible verdicts.
`data.case_summary`	An object containing the overall AI compliance evaluation summary for the search, including match classification counts, narrative, and recommendation.
`data.case_summary.true_positive_count`	The number of results in the search classified as True Positive.
`data.case_summary.potential_match_count`	The number of results in the search classified as Potential Match.
`data.case_summary.uncertain_count`	The number of results in the search classified as Uncertain.
`data.case_summary.false_positive_count`	The number of results in the search classified as False Positive.
`data.case_summary.true_negative_count`	The number of results in the search classified as True Negative.
`data.case_summary.narrative`	A human-readable summary describing the overall screening outcome and any recommended follow-up actions.
`data.case_summary.recommendation`	The AI's recommended next action based on the overall case classification (e.g. `"No Further Action Required"`, `"Enhanced Due Diligence Required"`).
`data.case_summary.entity_id`	The identifier of the entity this case summary applies to, when the search covers multiple entities; `null` otherwise.

Response​

Response