# Case Token

## uuid

**required**  
Globally unique identifier for the case.

---

## Parameters for Updating a Case
All fields are optional; omitted fields are left unchanged.  
The nullable fields `title`, `assignee`, and `sla_deadline` can be cleared by sending `null`.

### status

**string enum**  
Status of a case as it progresses through the review workflow:

- `OPEN`  
The case has been created and is still collecting matching transactions
- `ASSIGNED`  
An analyst has been assigned and transaction collection has stopped
- `IN_REVIEW`  
The case is actively being investigated
- `ESCALATED`  
The case has been reviewed and requires additional oversight
- `RESOLVED`  
A determination has been made and a resolution recorded
- `CLOSED`  
The case is finalized

**Allowed:**  
`OPEN`, `ASSIGNED`, `IN_REVIEW`, `ESCALATED`, `RESOLVED`, `CLOSED`

### title

**string | null**  
New title for the case, or `null` to clear it

### assignee

**string | null**  
New assignee for the case, or `null` to unassign

### resolution

**string enum**  
Outcome recorded when a case is resolved:

- `CONFIRMED_FRAUD`  
The reviewed activity was confirmed to be fraudulent
- `SUSPICIOUS_ACTIVITY`  
The activity is suspicious but not confirmed fraud
- `FALSE_POSITIVE`  
The activity was legitimate and the alert was a false positive
- `NO_ACTION_REQUIRED`  
No further action is required
- `ESCALATED_EXTERNAL`  
The case was escalated to an external party

**Allowed:**  
`CONFIRMED_FRAUD`, `SUSPICIOUS_ACTIVITY`, `FALSE_POSITIVE`, `NO_ACTION_REQUIRED`, `ESCALATED_EXTERNAL`

### resolution_notes

**string**  
Notes describing the resolution

### tags

**object**  
Arbitrary key-value metadata to set on the case

#### priority

**string enum**  
Priority level of a case, controlling queue ordering and SLA urgency

**Allowed:**  
`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`

### sla_deadline

**date-time | null**  
New SLA deadline for the case, or `null` to clear it

### actor_token

**string**  
Optional client-provided identifier for the actor performing this action, recorded on the resulting activity entry.

# `200 Case`

**object**  
A transaction monitoring case.

### token

**uuid**  
**required**  
Globally unique identifier for the case

### title

**string | null**  
**required**  
Short, human-readable summary of the case

### status

**string enum**  
**required**  
Status of a case as it progresses through the review workflow:

**Allowed:**  
`OPEN`, `ASSIGNED`, `IN_REVIEW`, `ESCALATED`, `RESOLVED`, `CLOSED`

### queue_token

**uuid**  
**required**  
Token of the queue the case belongs to

### priority

**string enum**  
**required**  
Priority level of a case, controlling queue ordering and SLA urgency

**Allowed:**  
`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`

### assignee

**string | null**  
**required**  
Identifier of the user the case is currently assigned to

### rule_token

**uuid | null**  
**required**  
Token of the transaction monitoring rule that triggered the case

### resolution

**nullResolution Outcome**  
**required**  
Outcome recorded when the case was resolved

### resolution_notes

**string | null**  
**required**  
Free-form notes describing the resolution

### sla_deadline

**date-time | null**  
**required**  
Deadline by which the case is expected to be resolved

### tags

**object**  
**required**  
Arbitrary key-value metadata associated with the case

### Additional Fields

#### created

**date-time**  
**required**  
Date and time at which the case was created

#### updated

**date-time**  
**required**  
Date and time at which the case was last updated

#### resolved

**date-time | null**  
**required**  
Date and time at which the case was resolved

#### collection_stopped

**date-time | null**  
**required**  
Date and time at which transaction collection stopped for the case

### entity

**null Case Entity**  
**required**  
The entity the case is associated with

### pending_transactions

**boolean**  
**required**  
Whether the case still has transaction scopes pending resolution

# `400 Bad Request`

# `404 Not Found`

---

# Example cURL Request

```bash
curl --request PATCH \
     --url https://sandbox.lithic.com/v1/transaction_monitoring/cases/case_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "OPEN",
  "title": "string",
  "assignee": "string",
  "resolution": "CONFIRMED_FRAUD",
  "resolution_notes": "string",
  "tags": {
    "additionalProp": "string"
  },
  "priority": "LOW",
  "sla_deadline": "2026-07-18T00:25:53.489Z",
  "actor_token": "string"
}
'
```

# Example JSON Response

```json
{
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "string",
  "status": "OPEN",
  "queue_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "priority": "LOW",
  "assignee": "string",
  "rule_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "resolution": "CONFIRMED_FRAUD",
  "resolution_notes": "string",
  "sla_deadline": "2026-07-18T00:25:53.489Z",
  "tags": {
    "additionalProp": "string"
  },
  "created": "2026-07-18T00:25:53.489Z",
  "updated": "2026-07-18T00:25:53.489Z",
  "resolved": "2026-07-18T00:25:53.489Z",
  "collection_stopped": "2026-07-18T00:25:53.489Z",
  "entity": {
    "entity_type": "CARD",
    "entity_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "pending_transactions": true
}
```

---

Updated about 2 months ago