List conversations
Conversations of one mailbox by status, assignee or search text, with who wrote last.
GET https://cotlet.dev/api/v1/freescout/mailbox/{mailbox_id}/conversations
read
Returns conversations of one mailbox in the order FreeScout lists them, one page at a time; follow page while has_more is true. status defaults to active. last_reply_from says whether the customer or a teammate wrote last, and waiting_since is the time of the customer message nobody has answered. Deleted conversations are left out. Putting # in front of a number in query finds that conversation number.
Parameters
| Name | Type | Description |
|---|---|---|
| mailbox_id integer required | integer | Mailbox ID from list_mailboxes. It is the number at the end of the mailbox settings address. |
| status string | string | active, pending, closed or spam. Default active. |
| assigned_to string | string | A user_id from list_users, or unassigned. |
| query string | string | Search text. Use #12345 to find a conversation by its number. |
| page integer | integer | Page number, starting at 1. Follow it while has_more is true. |
Request
curl https://cotlet.dev/api/v1/freescout/mailbox/1/conversations \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("freescout", "list_conversations", {"mailbox_id":1})const result = await cotlet.call('freescout', 'list_conversations', {"mailbox_id":1});cotlet call freescout list_conversations --data '{"mailbox_id":1}'Example response
{
"conversations": [
{
"conversation_id": 4821,
"number": 1207,
"subject": "Invoice shows the wrong VAT number",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"status": "active",
"assignee": null,
"last_reply_from": "customer",
"waiting_since": "2026-10-21T14:05:00Z",
"preview": "Our invoice from October lists the wrong VAT number. Can you fix it?"
},
{
"conversation_id": 4833,
"number": 1219,
"subject": "Re: Invoice shows the wrong VAT number",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"status": "active",
"assignee": null,
"last_reply_from": "customer",
"waiting_since": "2026-10-22T09:40:00Z",
"preview": "Still no answer on my invoice. Who can help?"
}
],
"page": 1,
"has_more": false
}