List conversations
Live chat conversations in the Tidio Inbox, in the order the Inbox shows them.
GET https://cotlet.dev/api/v1/tidio/conversations
read
Returns the live chat conversations of your account with the contact, the assigned operator and the last message. Filter by contact email to find one customer. Pages hold up to 50 conversations; pass next_cursor back as cursor for the next page. Reading does not mark anything as seen for the customer.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_email string | string | Only conversations of the contact with this email. |
| limit integer | integer | 1 to 50. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/tidio/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("tidio", "list_conversations")const result = await cotlet.call('tidio', 'list_conversations');cotlet call tidio list_conversationsExample response
{
"conversations": [
{
"conversation_id": "cv_5a21",
"contact_id": "c4d9e1a2-77b0-4e0f-9a31-5b2c8e6f0d13",
"contact_name": "Mark Dole",
"assigned_operator": "Dana Reyes",
"last_message": "Does the blue one come in size L?",
"last_message_from": "contact",
"last_message_at": "2026-10-16T14:02:00Z"
}
],
"next_cursor": null
}