Skip to Content
Prets Developer Portal

List case messages

GET
/v1/cases/{caseId}/messages

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 a case's conversation, oldest first: the opening request followed by replies from your team and Prets. Pass links.next.cursor back as cursor to fetch the next page.

Returns a page of messages in data, with hasMore and links.next. Messages cannot be edited; an erased message keeps its place with a placeholder body and redactedAt. Returns 404 when the case does not exist or is not visible to you.

Path Parameters

caseId*string

Platform case id (cas_{ULID})

Match^cas_[0-9A-HJKMNP-TV-Z]{26}$

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.

Response Body

A page of case messages, oldest first

application/json
  1. response

Paginated case conversation, oldest first

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/cas_01ARZ3NDEKTSV4RRFFQ69G5FAV/messages'
Example Response
{  "data": [    {      "messageId": "csmsg_01ARZ3NDEKTSV4RRFFQ69G5FAV",      "body": "We have received your request.",      "author": {        "type": "merchant",        "contactId": "con_01HYQ4R7T0WKM2XB8ZFPC3NDV9",        "name": "Jane Advisor"      },      "createdAt": "2024-12-31T14:30:00.000Z",      "redactedAt": "2026-08-16T07:10:00.000Z"    }  ],  "hasMore": true,  "links": {    "next": {      "href": "string",      "cursor": "string"    }  }}