List conversations

GET/api/v1/conversationsRead, no scope needed

The key's agent's conversations on every channel, most recent activity first.

Request

curlshell

curl -X GET "https://icebot.icebergaisolutions.com/api/v1/conversations?limit=50" \
  -H "Authorization: Bearer $ICEBOT_API_KEY"

Parameters

Name	In	Type	Description
`limit`	query	integer	Page size, 1 to 100. Default 50.
`before`	query	ISO 8601 timestamp	Cursor. Only conversations whose last message is older than this. Pass the last_message_at of the final row you received to fetch the next page.

Responses

`200`

One page. hasMore says whether another page exists.

200 responsejson

{
  "data": [
    {
      "id": "6f1c2a90-3b7e-4d55-9a1e-2c8f0b7d4e11",
      "channel": "whatsapp",
      "external_user_id": "60123456789",
      "status": "open",
      "last_message_at": "2026-09-27T03:14:07.512Z",
      "created_at": "2026-09-26T11:02:44.100Z"
    }
  ],
  "hasMore": false
}

Errors

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

Source of truth: /api/v1/conversations in apps/dashboard/app/api/v1/conversations/route.ts.