Get conversation
One conversation with every thread, oldest first, internal notes marked.
GET https://cotlet.dev/api/v1/freescout/conversations/{conversation_id}
read
Returns the subject, status, assignee, customer and all threads oldest first. type is customer for a customer message, message for a reply from your team and note for an internal note. Attachments are listed by file name; their contents are not downloaded. Use it before replying so a draft matches what the notes say.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation ID from list_conversations or get_conversation. It is not the #number shown in the list. |
Request
curl https://cotlet.dev/api/v1/freescout/conversations/1 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("freescout", "get_conversation", {"conversation_id":1})const result = await cotlet.call('freescout', 'get_conversation', {"conversation_id":1});cotlet call freescout get_conversation --data '{"conversation_id":1}'Example response
{
"conversation_id": 4821,
"number": 1207,
"subject": "Invoice shows the wrong VAT number",
"mailbox_id": 1,
"status": "active",
"assignee": null,
"customer": {
"customer_id": 311,
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"threads": [
{
"type": "customer",
"from": "Lena Ortiz",
"created_at": "2026-10-21T14:05:00Z",
"body": "Our invoice from October lists the wrong VAT number. Can you fix it?"
},
{
"type": "note",
"from": "Sam Okafor",
"created_at": "2026-10-22T08:30:00Z",
"body": "Billing checked: the VAT ID on file is right, the invoice template is old."
}
]
}