Stay organized with collections
Save and categorize content based on your preferences.
A risk case tracks how your business alerts, investigates, and acts on
suspicious or risky activity related to AML. A single risk case may consist of
many events and may include multiple parties, but each party must have its own
investigation process tracked through a risk case. In particular, each party in
a risk case should have distinct entries for events listed in the following
section.
Event types
To express these events, AML AI uses the following types in the
RiskCaseEvent table.
Initial alerts trigger the following event types:
AML_ALERT_GOOGLE: triggered using Google AML risk score
AML_ALERT_LEGACY: triggered by another automatic risk assessment system
AML_ALERT_ADHOC: manually triggered, for example, by the relationship
manager
AML_ALERT_EXPLORATORY: triggered based on considerations other than pure
risk, for example, data exploration to improve the quality of AML models
AML_ALERT_EXTERNAL: triggered based on an external request
Events for the start and the end of an investigation process trigger the
following event types:
AML_PROCESS_START: investigation process starts
AML_PROCESS_END: The investigation process is complete and no further
outcomes are expected. If there is no AML_SAR or AML_EXIT by this point,
then AML AI safely concludes there will be none.
Actions taken based on the investigation trigger the following event types:
AML_SAR: suspicious activity report (SAR) is filed against the party for
suspicious behavior
AML_EXIT: A customer exit is triggered. This event must have a
corresponding AML_PROCESS_START event for the same party and risk case ID.
Optionally, if the investigation identifies a period of suspicious activity, you
may add the following event types:
AML_SUSPICIOUS_ACTIVITY_START: this event marks the beginning of
suspicious activity identified during the investigation
AML_SUSPICIOUS_ACTIVITY_END: This event marks the end of suspicious
activity identified during the investigation.
Risk case stages and outcomes
Risk case event data helps AML AI understand the lifecycle of
risk cases and how to classify risk cases with positive outcomes (leading to an
exit), ongoing investigations (not finished yet), or negative outcomes (finished
and not leading to an exit).
Figure 1. Positive case example.
Figure 2. Negative case example.
The stages illustrated in the preceding diagrams can be expressed with risk case
events as in the following steps:
An alert is created for a given party.
Alerts are triggered in a number of different ways:
An ad hoc alert triggered manually somewhere within your business, for
example, by a relationship manager (type: AML_ALERT_ADHOC)
An automated alert triggered using a Google AML
risk score as input (type: AML_ALERT_GOOGLE)
An automated alert triggered by a rules-based or AI system other than
AML AI (type: AML_ALERT_LEGACY)
An alert triggered based on considerations other than pure risk, for
example, data exploration to improve quality of AML models
(type: AML_ALERT_EXPLORATORY)
An external request triggered an investigation process
(type: AML_ALERT_EXTERNAL)
An existing investigation process identifies risk with an additional
party and starts an investigation process into that party (type:
AML_ALERT_ADHOC).
If this alert is related to investigations of other parties and worked as
part of the same case, it can reuse the same risk case ID. Otherwise, a new
risk case ID should be used.
Following an alert, an AML investigation process starts
(type: AML_PROCESS_START).
While your process may consist of multiple investigation stages, this event
marks the start of the first stage.
During some investigations, risk is acted upon, or other alerts or
investigations for other parties are triggered.
A SAR is filed relating to AML risk of this customer (type: AML_SAR).
The investigation process triggers the process to exit the customer
(type: AML_EXIT).
The investigation process triggers an investigation
(AML_PROCESS_START) or an alert (AML_ALERT_ADHOC) for another party.
The investigation process concludes and no further investigation activity
for this party is expected as part of this risk case
(type: AML_PROCESS_END).
In particular, if there has not been an AML_SAR or AML_EXIT event prior
to the end of the process, then AML AI concludes that there
was not sufficient risk identified to justify these outcomes for this party.
Suspicious activity period: Risk case events are also used to specify the
period during which suspicious activity, if any, was identified. To identify
this period, you may specify a single AML_SUSPICIOUS_ACTIVITY_START and
AML_SUSPICIOUS_ACTIVITY_END pair for a given party and risk case ID. This
input helps models identify risk at the correct time, for example, during or
shortly after the period when the suspicious activity occurred.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eA risk case tracks the process of handling suspicious activity, including alerts, investigations, and actions, for Anti-Money Laundering (AML) purposes, and may involve multiple events and parties, each with their own investigation.\u003c/p\u003e\n"],["\u003cp\u003eAML AI utilizes specific event types, such as \u003ccode\u003eAML_ALERT_GOOGLE\u003c/code\u003e, \u003ccode\u003eAML_ALERT_LEGACY\u003c/code\u003e, \u003ccode\u003eAML_ALERT_ADHOC\u003c/code\u003e, \u003ccode\u003eAML_ALERT_EXPLORATORY\u003c/code\u003e, and \u003ccode\u003eAML_ALERT_EXTERNAL\u003c/code\u003e to represent initial alerts, which can be triggered automatically or manually.\u003c/p\u003e\n"],["\u003cp\u003eEvents like \u003ccode\u003eAML_PROCESS_START\u003c/code\u003e and \u003ccode\u003eAML_PROCESS_END\u003c/code\u003e mark the beginning and end of an investigation process, respectively, while \u003ccode\u003eAML_SAR\u003c/code\u003e and \u003ccode\u003eAML_EXIT\u003c/code\u003e indicate actions taken based on the investigation, specifically filing a suspicious activity report or exiting a customer.\u003c/p\u003e\n"],["\u003cp\u003eThe optional events \u003ccode\u003eAML_SUSPICIOUS_ACTIVITY_START\u003c/code\u003e and \u003ccode\u003eAML_SUSPICIOUS_ACTIVITY_END\u003c/code\u003e are used to define the time period of suspicious activity identified during an investigation, assisting models in identifying risk at the appropriate time.\u003c/p\u003e\n"],["\u003cp\u003eRisk case event data is crucial for AML AI to understand the lifecycle and classify cases as positive, negative, or ongoing based on whether they lead to a customer exit or not, and whether the investigation is complete.\u003c/p\u003e\n"]]],[],null,["# Lifecycle of a risk case\n\nA risk case tracks how your business alerts, investigates, and acts on\nsuspicious or risky activity related to AML. A single risk case may consist of\nmany events and may include multiple parties, but each party must have its own\ninvestigation process tracked through a risk case. In particular, each party in\na risk case should have distinct entries for events listed in the following\nsection.\n\nEvent types\n-----------\n\nTo express these events, AML AI uses the following types in the\n[RiskCaseEvent](/financial-services/anti-money-laundering/docs/reference/schemas/aml-input-data-model#riskcaseevent) table.\n| **Important:** Only include risk cases and events relevant to money laundering risk in the risk case events table. Exclude risk cases related to other risks.\n\nInitial alerts trigger the following event types:\n\n- `AML_ALERT_GOOGLE`: triggered using Google AML [risk score](/financial-services/anti-money-laundering/docs/concepts/glossary#risk-score)\n- `AML_ALERT_LEGACY`: triggered by another automatic risk assessment system\n- `AML_ALERT_ADHOC`: manually triggered, for example, by the relationship manager\n- `AML_ALERT_EXPLORATORY`: triggered based on considerations other than pure risk, for example, data exploration to improve the quality of AML models\n- `AML_ALERT_EXTERNAL`: triggered based on an external request\n\nEvents for the start and the end of an investigation process trigger the\nfollowing event types:\n\n- `AML_PROCESS_START`: investigation process starts\n- `AML_PROCESS_END`: The investigation process is complete and no further outcomes are expected. If there is no `AML_SAR` or `AML_EXIT` by this point, then AML AI safely concludes there will be none.\n\nActions taken based on the investigation trigger the following event types:\n\n- `AML_SAR`: suspicious activity report (SAR) is filed against the party for suspicious behavior\n- `AML_EXIT`: A customer exit is triggered. This event must have a corresponding `AML_PROCESS_START` event for the same party and risk case ID.\n\nOptionally, if the investigation identifies a period of suspicious activity, you\nmay add the following event types:\n\n- `AML_SUSPICIOUS_ACTIVITY_START`: this event marks the beginning of suspicious activity identified during the investigation\n- `AML_SUSPICIOUS_ACTIVITY_END`: This event marks the end of suspicious activity identified during the investigation.\n\n| **Important:** Make sure to specify a single `AML_SUSPICIOUS_ACTIVITY_START` event and a single `AML_SUSPICIOUS_ACTIVITY_END` event for a given party and risk case ID, or to not specify either. In the absence of `AML_SUSPICIOUS_ACTIVITY_START` and `AML_SUSPICIOUS_ACTIVITY_END`, AML AI selects a period prior to the start of the investigation process.\n\nRisk case stages and outcomes\n-----------------------------\n\nRisk case event data helps AML AI understand the lifecycle of\nrisk cases and how to classify risk cases with positive outcomes (leading to an\nexit), ongoing investigations (not finished yet), or negative outcomes (finished\nand not leading to an exit).\n\n\n**Figure 1.** Positive case example.\n\n\n**Figure 2.** Negative case example.\n\nThe stages illustrated in the preceding diagrams can be expressed with risk case\nevents as in the following steps:\n\n1. **An alert is created for a given party.**\n\n Alerts are triggered in a number of different ways:\n - An ad hoc alert triggered manually somewhere within your business, for example, by a relationship manager (`type: AML_ALERT_ADHOC`)\n - An automated alert triggered using a Google AML [risk score](/financial-services/anti-money-laundering/docs/concepts/glossary#risk-score) as input (`type: AML_ALERT_GOOGLE`)\n - An automated alert triggered by a rules-based or AI system other than AML AI (`type: AML_ALERT_LEGACY`)\n - An alert triggered based on considerations other than pure risk, for example, data exploration to improve quality of AML models (`type: AML_ALERT_EXPLORATORY`)\n - An external request triggered an investigation process (`type: AML_ALERT_EXTERNAL`)\n - An existing investigation process identifies risk with an additional party and starts an investigation process into that party (type: `AML_ALERT_ADHOC`).\n\n If this alert is related to investigations of other parties and worked as\n part of the same case, it can reuse the same risk case ID. Otherwise, a new\n risk case ID should be used.\n2. **Following an alert, an AML investigation process starts\n (`type: AML_PROCESS_START`).**\n\n While your process may consist of multiple investigation stages, this event\n marks the start of the first stage.\n3. **During some investigations, risk is acted upon, or other alerts or\n investigations for other parties are triggered**.\n\n - A SAR is filed relating to AML risk of this customer (`type: AML_SAR`).\n - The investigation process triggers the process to exit the customer (`type: AML_EXIT`).\n - The investigation process triggers an investigation (`AML_PROCESS_START`) or an alert (`AML_ALERT_ADHOC`) for another party.\n4. **The investigation process concludes and no further investigation activity\n for this party is expected as part of this risk case\n (`type: AML_PROCESS_END`).**\n\n In particular, if there has not been an `AML_SAR` or `AML_EXIT` event prior\n to the end of the process, then AML AI concludes that there\n was not sufficient risk identified to justify these outcomes for this party.\n\n**Suspicious activity period:** Risk case events are also used to specify the\nperiod during which suspicious activity, if any, was identified. To identify\nthis period, you may specify a single `AML_SUSPICIOUS_ACTIVITY_START` and\n`AML_SUSPICIOUS_ACTIVITY_END` pair for a given party and risk case ID. This\ninput helps models identify risk at the correct time, for example, during or\nshortly after the period when the suspicious activity occurred."]]