Skip to content
ClickFix
Sign inBook a demo
Documentation

List conversations

View as MarkdownOpen in ChatGPTOpen in ClaudeFeedback
GET
/v1/public-api/conversations

Scope: conversations:read. Paged list (limit, offset), limited to the conversations the member who created the key can see.

Authorization

integrationKey
headerAuthorizationBearer <cf_sk_…>

Organization API key (cf_sk_…), created under Organization → API and automations → API keys and sent as Authorization: Bearer cf_sk_….

Query Parameters

limit?integer
Range0 <= value <= 100
Default20
offset?integer
Range0 <= value
Default0

Response Body

Success

application/json
  1. response
success*boolean
data*unknown
meta?
Example Request
curl -X GET 'https://api.getclickfix.com/v1/public-api/conversations'
Example Response
{  "success": true,  "data": {    "items": [      {        "uuid": "8f0e5c2a-6b1d-4f3a-9c7e-2d4b6a8c0e1f",        "number": 1042,        "status": "open",        "priority": "normal",        "subject": "Delivery question",        "inbox": {          "uuid": "c2a9d7e4-1f3b-4c5d-8e6f-7a8b9c0d1e2f",          "name": "Web widget"        },        "contact": {          "uuid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",          "name": "Ayşe Yılmaz",          "external_id": "1001",          "identity_state": "verified"        },        "assignee": {          "uuid": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f",          "name": "Mehmet Kaya"        },        "created_at": "2026-11-11T09:15:00Z",        "updated_at": "2026-11-11T09:15:00Z"      }    ],    "total": 134,    "limit": 20,    "offset": 0  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}