GET
List messages (history)

Overview

Returns messages for a conversation, newest first (createdAt desc). Pagination is cursor-based on createdAt: pass the oldest createdAt you’ve already seen as ?before=... to fetch the next older page. This is the standard “infinite scroll up” mobile pattern. The endpoint reuses the participant gate from Get conversation, so the same 403 FORBIDDEN / 404 NOT_FOUND semantics apply.

Authentication

Bearer <accessToken> required. requireOnboarded middleware applied.

Path parameters

Query parameters

Request body

None.

Response — 200 OK

Message object

Receipt object

Example response

Paging sequence

The cursor is exclusive: createdAt < before, never <=. Use the previous page’s oldest createdAt verbatim — you will not get duplicate rows.

Error responses

Side effects

None — pure read. Reading a message does not add a readBy receipt; that requires an explicit mark-read call.

See also

curl