Skip to Content
Prets Developer Portal

List cases

GET
/v1/cases

to try read requests with your account, or paste an API key into the Authorization field. Create an API key in the Partner Portal.

Lists the cases on your organization's quotes, newest first. Filter by state, quoteId, or updatedSince for incremental sync, and pass links.next.cursor back as cursor to fetch the next page.

Returns a page of cases in data, with hasMore and links.next. data is an empty array when no case matches, and links.next is null on the last page. Read a case's conversation with List case messages.

Query Parameters

cursor?string

Opaque list cursor from a previous links.next.cursor

limit?integer

Page-size hint for the first page (1–250). Frozen into the Cursor for the rest of the scroll; ignored when cursor is present.

Range0 < value <= 250
expand?|array<string>

Repeated field names to expand. Allowlisted: none. Unknown names are invalid.

state?string

Filter to open or closed Cases

Value in"open""closed"
quoteId?string

Restrict the list to Cases on this Quote

Match^qot_[0-9A-HJKMNP-TV-Z]{26}$
updatedSince?string

Return Cases whose updatedAt is at or after this instant (incremental sync)

Formatdate-time

Response Body

A page of cases, newest first

application/json
  1. response

Paginated list of cases

data*array<||>
hasMore*boolean

True when another page exists; always equals links.next != null

links*

List pagination links. next is null on the last page

Authorization

bearerAuth
headerAuthorizationBearer <token>
Example Request
curl -X GET 'https://api.prets.app/v1/cases'
Example Response
{  "data": [    {      "caseId": "cas_01ARZ3NDEKTSV4RRFFQ69G5FAV",      "quote": {        "quoteId": "qot_01ARZ3NDEKTSV4RRFFQ69G5FAV"      },      "type": "merchant_feedback",      "requestType": "Reschedule Meeting",      "subject": "Customer wants a later install date",      "description": "The customer asked to move the appointment.",      "stage": "Prets Action",      "createdAt": "2026-08-14T09:12:04.000Z",      "expiresAt": "2026-09-09",      "createdBy": "Jane Advisor",      "updatedAt": "2026-08-16T11:03:22.000Z",      "state": "open",      "waitingOn": "prets",      "waitingSince": "2026-08-14T09:12:04.000Z"    }  ],  "hasMore": true,  "links": {    "next": {      "href": "string",      "cursor": "string"    }  }}