List messages in a conversation

GET/api/v1/conversations/{id}/messagesRead, no scope needed

The messages of one conversation, oldest first. Internal notes are never returned.

Request

curlshell

curl -X GET "https://icebot.icebergaisolutions.com/api/v1/conversations/6f1c2a90-3b7e-4d55-9a1e-2c8f0b7d4e11/messages?limit=50" \
  -H "Authorization: Bearer $ICEBOT_API_KEY"

Parameters

Name	In	Type	Description
`id` (required)	path	uuid	The conversation id.
`limit`	query	integer	Page size, 1 to 100. Default 50.
`before`	query	ISO 8601 timestamp	Forward cursor, despite its name: only messages created after this instant. Pass the created_at of the last message you have to read what came next.

Responses

`200`

One page of messages, oldest first.

200 responsejson

{
  "data": [
    {
      "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
      "role": "user",
      "content": "Ada nasi lemak hari ni?",
      "channel": "whatsapp",
      "created_at": "2026-09-27T03:13:58.004Z"
    },
    {
      "id": "f2a3b4c5-d6e7-4f8a-9b0c-1d2e3f4a5b6c",
      "role": "assistant",
      "content": "Ada! Nasi lemak ayam goreng RM12.90. Nak order berapa?",
      "channel": "whatsapp",
      "created_at": "2026-09-27T03:14:07.512Z"
    }
  ],
  "hasMore": false
}

Errors

Every endpoint can also return 401 (missing, unknown or revoked key), 403 (origin not allowed) and 429 (rate limited). See Errors.

Status	error	When
`404`	`conversation not found`	The id does not exist or belongs to another agent. The two are indistinguishable on purpose.

Source of truth: /api/v1/conversations/{id}/messages in apps/dashboard/app/api/v1/conversations/[id]/messages/route.ts.