---
title: "List cases"
method: GET
path: "/user/cases"
tags: ["user-cases"]
---

# List cases

`GET /user/cases`

List support/dispute cases for the authenticated buyer.

Use this endpoint for account case inboxes and resolution tracking views.

Query behavior:
- Supports pagination and sorting by creation/update timestamps.

Response behavior:
- Returns only cases belonging to purchases made by the authenticated user.
- Includes outcomes and attachments.
- Redacts seller delivery address data on seller outcomes until those outcomes are accepted.

## Query parameters

- `page` integer — Page number, defaults to 1
- `size` integer — Results per page, defaults to 20
- `sort` 'createdAt' | 'updatedAt' — Field to sort by
- `direction` 'asc' | 'desc' — Sort direction

## Response `200`

User cases

- object[]
  - `id` string, cuid2, required
  - `workflowId` string, required
  - `purchaseId` string, required
  - `reason` 'SNAD' | 'DAMAGED' | 'WRONG_ITEM' | 'NOT_RECEIVED' | 'OTHER' | 'CHARGEBACK', required
  - `comment` string, nullable
  - `status` 'OPEN' | 'REMEDIATION' | 'SETTLED' | 'CLOSED' | 'ESCALATED', required
  - `createdAt` string, date-time, nullable, required
  - `updatedAt` string, date-time, nullable, required
  - `outcomes` object[], required
    - `id` string, cuid2, required
    - `type` 'RETURN' | 'REFUND' | 'REPLACEMENT', required
    - `party` 'SELLER' | 'BUYER' | 'SYSTEM', required
    - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'RESOLVED', required
    - `caseId` string, cuid2, required
    - `amount` integer, required
    - `comment` string, nullable
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `deliveryAddress` unknown
  - `attachments` object[], required
    - `url` string, uri, required
    - `party` 'SELLER' | 'BUYER' | 'SYSTEM', required
    - `createdAt` union, required
      - string, date-time
      - string, date-time

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/5ed45d6a9e2f/schema)