v14

OpenAPI 3.1.02026-08-03122113375.9 KB
user-cases

List 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.
get/user/cases

Query parameters

pageinteger

Page number, defaults to 1

Page number, defaults to 1

sizeinteger

Results per page, defaults to 20

Results per page, defaults to 20

sort'createdAt' | 'updatedAt'

Field to sort by

Field to sort by

direction'asc' | 'desc'

Sort direction

Sort direction

Response

User cases

idstring cuid2 required
workflowIdstring required
purchaseIdstring required
reason'SNAD' | 'DAMAGED' | 'WRONG_ITEM' | 'NOT_RECEIVED' | 'OTHER' | 'CHARGEBACK' required
commentstring nullable
status'OPEN' | 'REMEDIATION' | 'SETTLED' | 'CLOSED' | 'ESCALATED' required
createdAtstring date-time nullable required
updatedAtstring date-time nullable required