API referenceConversations
List a conversation’s messages
GET
Newest first.
ApiKeyheader
AuthorizationBearer <token>An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).
id*stringThe conversation id.
Format
uuidlimit?stringPage size, 1–100 (default 25).
after?stringA nextCursor from the previous page. Opaque.
before?stringA prevCursor, to page back. Opaque. Not with after.
direction?stringValue in
"inbound""outbound"includeNotes?stringtrue to interleave internal notes (type note). Default false.
includeSystem?stringtrue to include system / internal rows. Default false.
Gauge-Version?stringA dated version. Default 2026-10-21.
A page of messages (and notes, when asked for).
application/json- response
A cursor page over (created_at, id). Every list returns this shape.
data*array<>nextCursor*|Pass as after for the next page; null on the last page.
prevCursor*|Pass as before for the previous page; null on the first page.
curl -X GET 'https://app.gauge.chat/api/v2/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages'Example Response
{ "nextCursor": "string", "prevCursor": "string", "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a", "type": "message", "direction": "inbound", "authorType": "string", "authorMemberId": "76fc4ed4-930e-473e-a8fc-09f425f86e65", "kind": "string", "text": "string", "status": "string", "failureReason": "string", "media": { "mime": "string", "filename": "string", "mediaId": "5a8ffac5-2288-485d-b463-90c3cd9941ad" }, "template": { "name": "string", "language": "string" }, "via": "string", "replyToMessageId": "666dd795-555f-462a-8c3b-fb8ab1fdc45f", "metadata": { "property1": "string", "property2": "string" }, "createdAt": "string" } ]}