List Messages

Retrieve paginated messages from a conversation. Messages are returned in descending order by creation date. Requires Plus plan or higher.

GET

/api/v1/agents/{id}/conversations/{conversationId}/messages

Plus+

Parameters

Name	Type	Required	Description
id	string	Required	Agent ID (Path)
conversationId	string	Required	Conversation ID (Path)
limit	integer		Max messages per page (default: 20, max: 100)
cursor	string		Opaque cursor for next page (from previous response)

Response Schema

json

{
  "messages": [
    {
      "id": 123,
      "query": "User message text",
      "response": "AI response text",
      "createdAt": "2026-02-24T12:00:00.000Z",
      "rating": "positive" | "negative" | null
    }
  ],
  "nextCursor": "456" | null
}

Code Examples

curl -X GET "https://chatspark.io/api/v1/agents/ag_123/conversations/conv_abc/messages?limit=20" \
  -H "Authorization: Bearer cs_live_..."

Get Conversation

List Leads