Skip to main content
GET
/
:projectId
/
api
/
v7
/
conversations
/
:conversationId
/
messages
List Messages
curl --request GET \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/conversations/:conversationId/messages
{
  "messages": [
    {}
  ],
  "hasMore": true,
  "oldestCreatedAt": {},
  "newestCreatedAt": {}
}
Returns a cursor-paginated list of ChatMessage objects. By default returns the main conversation stream (excludes thread replies). Pass parentId to fetch replies for a specific thread. The caller must be a member. Former members (who left) can only read messages up to when they left.

​
Path Parameters

​
conversationId
string
required
The ID of the conversation.

​
Query Parameters

​
parentId
string
If provided, returns thread replies to this message instead of the main stream.
​
before
string
ISO 8601 timestamp. Returns messages created before this time. Used for loading older messages. Mutually exclusive with after.
​
after
string
ISO 8601 timestamp. Returns messages created after this time. Used for loading newer messages. Mutually exclusive with before.
​
limit
number
Number of messages to return. Defaults to 50.
​
sort
string
Sort order: asc or desc. Defaults to desc for the main stream, asc for threads.
​
include
string
Comma-separated list of extra fields to include. Currently supports files. Example: include=files.

​
Response

​
messages
ChatMessage[]
Array of message objects. Each includes reactionCounts, userReactions, user, and quotedMessage fields. File attachments are included only when include=files is specified.
​
hasMore
boolean
Whether more messages exist in the requested direction.
​
oldestCreatedAt
string | null
ISO timestamp of the oldest message in this page. null if no messages were returned.
​
newestCreatedAt
string | null
ISO timestamp of the newest message in this page. null if no messages were returned.

​
Error Responses

{ "error": "You are not a member of this conversation.", "code": "chat/not-a-member" }