Cases
A case represents an AML investigation into an entity. Cases aggregate alerts, risk assessments, verification checks, and reviewer workflows.Resource fields
| Field | Type | Description |
|---|---|---|
token | string | Unique case identifier (prefix cas_) |
name | string | Auto-generated case reference (e.g., AML-2026-0042) |
type | string | Case type: Onboarding, Review, Perpetual |
status | string | Current status. See Status Enums |
priority | string | Priority level: Critical, High, Medium, Low |
risk_tier | string | Overall risk tier: High, Medium, Low |
risk_score | number | Numeric risk score (0-100) |
entity_token | string | Token of the primary entity under investigation |
entity_name | string | Name of the primary entity |
entity_type | string | Entity type: company or person |
assigned_to | object | Assigned analyst (see User object below) |
escalated_to | object | Manager the case is escalated to (see User object) |
escalation_date | string | ISO 8601 timestamp of escalation |
escalation_reason | string | Reason for escalation |
start_date | string | ISO 8601 timestamp of case creation |
due_date | string | ISO 8601 date of SLA deadline |
completed_at | string | ISO 8601 timestamp of case closure |
resolution_notes | string | Resolution summary written at closure |
open_alerts_count | number | Count of unresolved alerts on this case |
external_reference | string | Your external reference ID for idempotency |
sla_status | string | SLA status: On Track, Warning, Critical, Breached |
checks_summary | object | Summary of check outcomes (see below) |
risk_assessment | object | Latest risk assessment (see below) |
created_at | string | ISO 8601 timestamp of creation |
updated_at | string | ISO 8601 timestamp of last modification |
Nested objects
User object
| Field | Type | Description |
|---|---|---|
id | string | User identifier |
name | string | Display name |
email | string | Email address |
Checks summary object
| Field | Type | Description |
|---|---|---|
total | number | Total checks created |
passed | number | Checks with Pass result |
referred | number | Checks with Refer result |
failed | number | Checks with Fail result |
waived | number | Checks manually waived |
reused | number | Checks reused from other cases |
pending | number | Checks still in progress or pending |
Risk assessment object
| Field | Type | Description |
|---|---|---|
overall_score | number | Calculated overall risk score (0-100) |
tier | string | Overall tier: High, Medium, Low |
customer_risk | object | Customer dimension { score, tier } |
geographic_risk | object | Geographic dimension { score, tier } |
product_risk | object | Product/Service dimension { score, tier } |
channel_risk | object | Channel dimension { score, tier } |
override_tier | string | Analyst override tier (if applicable) |
override_reason | string | Override justification |
edd_required | boolean | Whether EDD is required based on risk |
Example
{
"token": "cas_xyz789",
"name": "AML-2026-0042",
"type": "Onboarding",
"status": "In Progress",
"priority": "Medium",
"risk_tier": "Medium",
"risk_score": 45,
"entity_token": "ent_abc123",
"entity_name": "Acme Holdings Ltd",
"entity_type": "company",
"assigned_to": {
"id": "user_analyst01",
"name": "Sarah Johnson",
"email": "sarah@example.com"
},
"escalated_to": null,
"escalation_date": null,
"start_date": "2026-02-16T10:01:00Z",
"due_date": "2026-03-02",
"completed_at": null,
"resolution_notes": null,
"open_alerts_count": 1,
"external_reference": "YOUR-REF-2026-0042",
"sla_status": "On Track",
"checks_summary": {
"total": 6,
"passed": 3,
"referred": 1,
"failed": 0,
"waived": 0,
"reused": 0,
"pending": 2
},
"created_at": "2026-02-16T10:01:00Z",
"updated_at": "2026-02-16T11:00:00Z"
}
Related endpoints
| Endpoint | Method | Description |
|---|---|---|
GET /v1/cases | GET | List cases with filters |
POST /v1/cases | POST | Create a new case |
GET /v1/cases/{token} | GET | Get case details |
POST /v1/cases/{token}/close | POST | Close a case |
POST /v1/cases/{token}/escalate | POST | Escalate a case |
GET /v1/cases/{token}/alerts | GET | List alerts for a case |
GET /v1/cases/{token}/checks | GET | List checks for a case |
GET /v1/cases/{token}/entities | GET | List entities for a case |
GET /v1/cases/{token}/audit-logs | GET | List audit logs for a case |
GET /v1/cases/{token}/comments | GET | List comments for a case |
GET /v1/cases/{token}/compliance-report | GET | Generate compliance report |