---
title: "List cases"
method: GET
path: "/v1/transaction_monitoring/cases"
tags: ["Transaction Monitoring"]
---

# List cases

`GET /v1/transaction_monitoring/cases`

Lists transaction monitoring cases, optionally filtered.

## Query parameters

- `queue_token` string, uuid
- `status` 'OPEN' | 'ASSIGNED' | 'IN_REVIEW' | 'ESCALATED' | 'RESOLVED' | 'CLOSED' — 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
- `assignee` string
- `rule_token` string, uuid
- `transaction_token` string, uuid
- `card_token` string, uuid
- `account_token` string, uuid
- `entity_token` string, uuid
- `sort_by` 'CREATED_ASC' | 'CREATED_DESC' | 'PRIORITY_DESC' | 'PRIORITY_ASC' | 'STATUS_DESC' | 'STATUS_ASC' — Sort order for listing cases. Defaults to `CREATED_DESC` (newest first): - `CREATED_ASC` - Oldest first - `CREATED_DESC` - Newest first - `PRIORITY_DESC` - Highest priority first - `PRIORITY_ASC` - Lowest priority first - `STATUS_DESC` - Furthest workflow stage first - `STATUS_ASC` - Earliest workflow stage first
- `begin` string, date-time
- `end` string, date-time
- `starting_after` string, uuid
- `ending_before` string, uuid
- `page_size` integer

## Response `200`

Cases

- object
  - `data` MonitoringCase[], required
    - `token` string, uuid, required — Globally unique identifier for the case
    - `title` string, nullable, required — Short, human-readable summary of the case
    - `status` 'OPEN' | 'ASSIGNED' | 'IN_REVIEW' | 'ESCALATED' | 'RESOLVED' | 'CLOSED', required — 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
    - `queue_token` string, uuid, required — Token of the queue the case belongs to
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL', required — Priority level of a case, controlling queue ordering and SLA urgency
    - `assignee` string, nullable, required — Identifier of the user the case is currently assigned to
    - `rule_token` string, uuid, nullable, required — Token of the transaction monitoring rule that triggered the case
    - `resolution` string, nullable, required — Outcome recorded when the case was resolved, from the `allowed_resolutions` configured on the case's queue
    - `resolution_notes` string, nullable, required — Free-form notes describing the resolution
    - `sla_deadline` string, date-time, nullable, required — Deadline by which the case is expected to be resolved
    - `tags` object, required — Arbitrary key-value metadata associated with the case
    - `created` string, date-time, required — Date and time at which the case was created
    - `updated` string, date-time, required — Date and time at which the case was last updated
    - `resolved` string, date-time, nullable, required — Date and time at which the case was resolved
    - `collection_stopped` string, date-time, nullable, required — Date and time at which transaction collection stopped for the case
    - `entity` CaseEntity, required — The entity a case is associated with
      - `entity_type` 'CARD' | 'ACCOUNT', required — The type of entity a case is associated with: - `CARD` - The case is associated with a card - `ACCOUNT` - The case is associated with an account
      - `entity_token` string, uuid, required — Globally unique identifier for the associated entity
    - `pending_transactions` boolean, required — Whether the case still has transaction scopes pending resolution
  - `has_more` boolean, required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)