POST/v1/cases

Create case

Initiate a manual investigation partition. Most cases are auto-created by the institutional scoring engine, but manual creation allows human-initiated oversight of suspicious entities or activities.

Authentication ProtocolBearer <API_KEY>

Path Parameters

titlestringRequired

Descriptive high-level title of the investigation.

descriptionstringRequired

Investigative brief and initial findings/rationale.

prioritystringRequired

low, medium, high, or urgent (Determines SLA duty).

related_customer_idinteger

Internal institutional customer identifier.

related_account_idinteger

Financial account identifier.

alert_idsinteger[]

Link existing alerts to this case on creation.

Transmission Examples

curl
curl -X POST https://api.topsafe.ai/api/v1/cases \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "X-API-Key: YOUR_INSTITUTION_KEY" \
  -d '{
    "title": "Suspicious Structuring Pattern - Branch Lagos",
    "description": "Entity 74 exhibiting cash deposit velocity just below N5M threshold.",
    "priority": "high",
    "related_customer_id": 74,
    "alert_ids": [50, 51]
  }'

Schema Response

json
{
  "success": true,
  "data": {
    "id": 29,
    "case_number": "CASE-DEBN-20260421-00004",
    "title": "Suspicious Structuring Pattern - Branch Lagos",
    "priority": "high",
    "status": "open",
    "owner_id": 39,
    "sla_due_at": "2026-04-22T10:42:00+00:00",
    "created_at": "2026-04-21T10:42:00+00:00"
  }
}
Preliminary ResourceList casesSuccessive Directive Retrieve case