List Conversations

Updated about 2 hours ago•1 min read

GET

/v1/conversations

Returns a paginated list of conversations in the workspace. Supports filtering by status (active, closed, snoozed, resolved).

Parameters

Name	Type	Description
`status`	string	Filter by status: 'active', 'closed', 'snoozed', 'resolved'
`page`	integer	Page number (default: 1)
`per_page`	integer	Records per page (1-100, default: 20)

Responses

200List of conversations

{
  "data": [
    {
      "id": "cnv_777",
      "identifier": "CNV-1029",
      "title": "Payment Gateway Error",
      "status": "active",
      "priority": "high",
      "inbox_id": "inb_901",
      "assignee_id": "usr_888",
      "team_id": "tm_301",
      "created_at": "2026-09-02T13:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 8,
    "total_count": 152,
    "per_page": 20
  }
}