Skip to content
GET/conversations/{conversationId}/messages

List messages in a conversation

Returns a paginated list of messages in a conversation. Internal agent notes are excluded by default. Requires a team-role API key.

Parameters

NameInTypeDescription
conversationIdrequiredpathstringConversation ID
includeInternalquerybooleanInclude internal agent notes (default: false)
cursorquerystringPagination cursor from previous response
limitqueryintegerItems per page (max 100)(default: 30)

Response

List of messages

Returns an array of objects:

FieldTypeDescription
idrequiredstringTypeID - a type-prefixed UUID
conversationIdrequiredstringTypeID - a type-prefixed UUID
senderTyperequired"visitor" | "agent" | "system"Who sent the message
isInternalrequiredbooleanWhether this is an internal agent note not visible to the visitor
authorPrincipalIdrequiredstring | nullPrincipal ID of the author, null for system messages
authorNamerequiredstring | nullDisplay name of the author, null for system messages
contentrequiredstring
createdAtrequiredstringISO 8601 timestamp

meta

FieldTypeDescription
paginationrequiredobject

Errors

401Unauthorized
404Conversation not found

Example request

curl \
  "https://feedback.quackback.io/api/v1/conversations/:conversationId/messages" \
  -H "Authorization: Bearer qb_your_api_key_here"