Case management

A case (expediente) is the regulatory record of a fraud incident. Cases are often created automatically by report-fraud, but you can also create and manage them directly.

Case endpoints belong to the management surface and authenticate with a dashboard session JWT, not API keys. See Authentication.

Lifecycle

borrador → en_revision → enviado → resuelto
                                 ↘ archivado

Status	Meaning
`borrador`	Draft, still being assembled
`en_revision`	Under internal review
`enviado`	Submitted to the regulator
`resuelto`	Resolved
`archivado`	Archived

Create a case

curl -X POST "$CLAUSUM_API_BASE/api/v1/cases" \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "incident_date": "2026-05-20",
    "incident_type": "transferencia_no_autorizada",
    "amount": 250000,
    "currency": "CLP",
    "jurisdiction": "CL",
    "victim_name": "Jane Doe",
    "victim_email": "jane@example.com",
    "priority": "alta",
    "description": "Unauthorized wire transfer following phishing."
  }'

Jurisdictions & currencies

Jurisdiction	Country	Common currency
`CL`	Chile	`CLP`
`MX`	Mexico	`MXN`
`BR`	Brazil	`BRL`
`PE`	Peru	`PEN`
`CO`	Colombia	`COP`
`UY`	Uruguay	`UYU`
`AR`	Argentina	`ARS`

Incident types: phishing, ingenieria_social, transferencia_no_autorizada, robo_identidad, fraude_interno, otro.

List & filter

curl "$CLAUSUM_API_BASE/api/v1/cases?status=en_revision&jurisdiction=CL&limit=50" \
  -H "Authorization: Bearer $DASHBOARD_JWT"

Supports status, priority, jurisdiction, search, from_date, to_date, limit, offset, sort_by, and sort_order.

Update a case

curl -X PATCH "$CLAUSUM_API_BASE/api/v1/cases/$CASE_ID" \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "status": "en_revision", "priority": "urgente" }'

Submit to the regulator

curl -X POST "$CLAUSUM_API_BASE/api/v1/cases/$CASE_ID/submit" \
  -H "Authorization: Bearer $DASHBOARD_JWT"

Returns 409 Conflict if the case was already submitted.

Statistics

Get aggregated counts for dashboards:

curl "$CLAUSUM_API_BASE/api/v1/cases/stats" \
  -H "Authorization: Bearer $DASHBOARD_JWT"

{
  "total": 128,
  "by_status": { "borrador": 12, "en_revision": 30, "enviado": 70, "resuelto": 16 },
  "by_priority": { "baja": 20, "normal": 60, "alta": 38, "urgente": 10 },
  "total_amount": 48750000
}

Evidence & transactions

Each case can hold evidence and linked transactions:

GET/POST /api/v1/cases/{id}/evidence
GET/POST /api/v1/cases/{id}/transactions
GET /api/v1/cases/{id}/activity — paginated activity log

Explore them in the API Reference.

Get started

Integrate by client type

Capabilities — prevention

Capabilities — events & ops

Dashboard

Core concepts

Reference

Case management

Lifecycle

Create a case

Jurisdictions & currencies

List & filter

Update a case

Submit to the regulator

Statistics

Evidence & transactions

​Lifecycle

​Create a case

​Jurisdictions & currencies

​List & filter

​Update a case

​Submit to the regulator

​Statistics

​Evidence & transactions

Lifecycle

Create a case

Jurisdictions & currencies

List & filter

Update a case

Submit to the regulator

Statistics

Evidence & transactions