List 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.
cursor?stringOpaque list cursor from a previous links.next.cursor
limit?integerPage-size hint for the first page (1–250). Frozen into the Cursor for the rest of the scroll; ignored when cursor is present.
0 < value <= 250expand?|array<string>Repeated field names to expand. Allowlisted: none. Unknown names are invalid.
state?stringFilter to open or closed Cases
"open""closed"quoteId?stringRestrict the list to Cases on this Quote
^qot_[0-9A-HJKMNP-TV-Z]{26}$updatedSince?stringReturn Cases whose updatedAt is at or after this instant (incremental sync)
date-timeA page of cases, newest first
application/json- response
Paginated list of cases
data*array<||>hasMore*booleanTrue when another page exists; always equals links.next != null
links*List pagination links. next is null on the last page
bearerAuthAuthorizationBearer <token>curl -X GET 'https://api.prets.app/v1/cases'{ "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" } }}