List conversations
Conversations of your account with status, assignee, labels, priority and the last message.
GET https://cotlet.dev/api/v1/chatwoot/conversations
read
Returns one page of conversations, most recent activity first, with status, priority, inbox, channel, contact, assignee, labels, unread_count, last_message and last_activity_at. status picks the Chatwoot state: open, pending, resolved, snoozed or all. assignee is me, unassigned, assigned or all. query matches the text of messages. Pass page back for the next one and stop when has_more is false.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | open, pending, resolved, snoozed or all. Default: open. |
| assignee string | string | me, unassigned, assigned or all. Default: all. |
| inbox_id integer | integer | inbox_id from list_inboxes. |
| label string | string | Label name from list_labels. |
| contact_id integer | integer | contact_id from search_contacts, for the conversations of one contact. |
| query string | string | Text to find in the messages. |
| page integer | integer | Page number, from 1. Default: 1. |
Request
curl https://cotlet.dev/api/v1/chatwoot/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("chatwoot", "list_conversations")const result = await cotlet.call('chatwoot', 'list_conversations');cotlet call chatwoot list_conversationsExample response
{
"conversations": [
{
"conversation_id": 1842,
"status": "open",
"priority": null,
"inbox": "Support email",
"channel": "email",
"contact": {
"contact_id": 311,
"name": "Dana Whitfield"
},
"assignee": null,
"labels": [],
"unread_count": 2,
"last_message": {
"sender": "contact",
"content": "I was charged twice for October. Can you refund one payment?",
"created_at": "2026-10-22T06:41:00Z"
},
"last_activity_at": "2026-10-22T06:41:00Z"
},
{
"conversation_id": 1851,
"status": "open",
"priority": null,
"inbox": "Website chat",
"channel": "web_widget",
"contact": {
"contact_id": 327,
"name": "Priya Nair"
},
"assignee": null,
"labels": [],
"unread_count": 1,
"last_message": {
"sender": "contact",
"content": "I cannot find where to reset my password.",
"created_at": "2026-10-22T07:12:00Z"
},
"last_activity_at": "2026-10-22T07:12:00Z"
}
],
"page": 1,
"has_more": false
}