List conversation messages

List all messages in a conversation with cursor-based pagination. Messages are returned in chronological order within each page, paginating backward from newest. The cursor from the get-conversation endpoint works here.

GET /agents/{agentId}/conversations/{conversationId}/messages

List conversation messages

cURL

curl --request GET \
  --url https://www.chatbase.co/api/v2/agents/{agentId}/conversations/{conversationId}/messages \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "role": "user",
      "parts": [
        {
          "type": "text",
          "text": "<string>"
        }
      ],
      "createdAt": 123,
      "feedback": "positive",
      "metadata": {
        "score": 123
      }
    }
  ],
  "pagination": {
    "cursor": "<string>",
    "hasMore": true,
    "total": 123
  }
}

Authorizations

Authorization · string · header · required

API key from your account settings

Path Parameters

agentId · string · required

The agent ID

Minimum string length: 1

Example:

"5QHA6VB-DIAbBhxwqxfdi"

conversationId · string · required

The conversation ID

Minimum string length: 1

Example:

"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

Query Parameters

cursor · string

Opaque cursor from a previous response to fetch the next page

Example:

"eyJ0IjoiMjAyNC0wMS0xNVQxMDozMDowMC4wMDBaIiwiaWQiOiJhYmMxMjMifQ=="

limit · integer · default: 20

Number of items per page (1–100, default 20)

Required range: 1 <= x <= 100

Example:

20

Response

200

application/json

Paginated list of messages

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes