/v1/communities/{community_id}/conversations/{conversation_id}/messagesAuthList messages in the conversation. Default newest-first cursor. Pass `since` (encoded cursor of the last-seen message) to poll for newer messages instead.
Path parameters
community_id*stringSocial community UUID. Must belong to the PAK's workspace.
conversation_id*stringConversation UUID.
Query parameters
actor_id*string · uuidThe viewer actor UUID — must be a participant.
limitintegerMaximum number of items to return (1-200, default 50).
cursorstringOpaque cursor from the previous page's `pagination.next_cursor`; omit for the first page.
sincestringPolling cursor — encoded last-seen message id; returns newer messages in ascending order.
Response · 200 Page of messages.
data*arrayThe messages on this page.
pagination*objectnext_cursor*stringOpaque base64url cursor for the next page; `null` when no further pages.
Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMC4wMDBaIiwiaWQiOiJiYmJiIn0"
has_more*boolean`true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor. A short or empty `data` array does NOT imply the end of the list when a lane post-filters — always page until this is `false`.
Example: true
Example
Request
GET https://social.productcraft.co/v1/communities/{community_id}/conversations/{conversation_id}/messages
Authorization: Bearer YOUR_TOKENResponse
{
"data": [
{
"id": "eeeeeeee-0000-0000-0000-000000000001",
"conversation_id": "11111111-2222-3333-4444-555555555555",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"sender_id": "aaaaaaaa-0000-0000-0000-000000000001",
"kind": "text",
"body": "Hey there.",
"attachments": [
{
"kind": "image",
"url": "https://cdn.example/attachments/abc.png"
}
],
"assets": [
{
"asset_id": "eeeeeeee-0000-0000-0000-000000000001",
"alt_text": "A golden retriever on a beach"
}
],
"reply_to_id": null,
"edited_at": null,
"deleted_at": null,
"reaction_counts": {
"like": 1
},
"created_at": "2026-05-01T12:00:00.000Z"
}
],
"pagination": {
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMC4wMDBaIiwiaWQiOiJiYmJiIn0",
"has_more": true
}
}