List conversations

GET/v1/conversations

Auth: Secret API key (rk_sk_)

List conversations with cursor pagination. Returns { data, has_more, next_cursor } for API key auth.

Query parameters

Name	Type	Description
`site_id`	`uuid`	Filter by site
`status`	`string`	open \| pending \| closed
`assignee_id`	`uuid`	Filter by assigned agent
`unassigned`	`boolean`	true \| false
`visitor_id`	`uuid`	Filter by visitor
`limit`	`integer`	1–100, default 20
`cursor`	`string`	Pagination cursor

Responses

200Paginated list

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "siteId": "660e8400-e29b-41d4-a716-446655440001",
      "visitorId": "770e8400-e29b-41d4-a716-446655440002",
      "status": "open",
      "assigneeId": null,
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:05:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}