Get a conversation

The message history of one chat.

GET https://cotlet.dev/api/v1/kommo/chats/{chat_id}/conversation

read

Returns messages newest first, each with who wrote it (client, user or bot), the text and the time. Images, voice messages and files come back as a type label without the content. Follow next_cursor for older messages.

Parameters

Parameters: get_conversation
NameTypeDescription
chat_id string required string Chat ID from list_conversations or list_incoming_leads.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/kommo/chats/chat_8c41d2/conversation \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("kommo", "get_conversation", {"chat_id":"chat_8c41d2"})
Node.js
const result = await cotlet.call('kommo', 'get_conversation', {"chat_id":"chat_8c41d2"});
CLI
cotlet call kommo get_conversation --data '{"chat_id":"chat_8c41d2"}'

Example response

JSON

{
  "chat_id": "c4b19e07",
  "channel": "WhatsApp",
  "lead_id": 24518301,
  "messages": [
    {
      "from": "client",
      "text": "What does the yoga studio package cost per month?",
      "at": "2026-10-19T18:03:00+02:00"
    },
    {
      "from": "user",
      "text": "Hi Ana, thanks for writing. I will send the details.",
      "at": "2026-10-19T09:30:00+02:00"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.