How AML Screening & Monitoring Works

Workflow

Architecture model

Select Level→Submit Application→AML Step Executes→Result / Case

AML screening is encapsulated as an AML Screening check inside a Level. Customers trigger screening by creating an Application.
All AML results are aggregated into a Case tied to the Profile.

Two Ways to Trigger Screening

Via API

Recommended for automated, production-scale integrations.

Select a Level ID (with AML configured)
POST to /v1/individual/applications with user identity info
System creates Application, executes AML asynchronously
Poll Application status or receive Webhook notification
If hit: Case + Alert generated; Application enters onHold
If no hit: Application proceeds to completed

Via Portal (Manual)

For ad-hoc screening directly in the Dashboard.

Navigate to Applications → Individuals
Click the AML Screening entry button
Select a Level from the dropdown
Fill in identity info (form renders from Level schema)
Click Create Application
View result in Application detail page

Key Rules

Each externalUserId can only have
one Initial Screening. If an active session already exists,
the API returns an error.
Standalone AML mode: the system automatically creates a Profile and associates the Application.
eKYC + AML combined mode: the Application is linked to an existing Profile; the AML step runs after other steps complete.
If screening fails with Application status
Error, click the
Retry button on the Application detail page to re-run with
the same input parameters.

Result Outcomes

Outcome	Application Status	Next Step
✅ No hit	`completed` / reviewAnswer: GREEN	No action needed.
⚠️ Hit detected	`onHold`	Compliance officer reviews the Case and resolves Matches.
❌ Screening error	`error`	Click Retry in Application detail page.

Case & Alert Model

ℹ️ One Case per Profile

Every Profile has exactly one AML Case. All Alerts from every screening session (initial, re-screening, or Ongoing Monitoring) are consolidated under that single Case.

When a screening hit is detected → a new Alert is created under the Profile's Case
If the Case was previously CLOSED (Approved/Rejected), a new Alert automatically reopens the Case to PENDING
Compliance officers work through the Alert's Matches to reach a final resolution
When all Matches are resolved and all Alerts closed → the Case can be submitted, Approve or Reject