Get chat
Full transcript of one chat with every message, private note and tag.
GET https://cotlet.dev/api/v1/livechat/chats/{chat_id}
read
Returns one chat, active or archived, with all messages in order, oldest first, the private notes your role can see, the tags and the agents who took part. Use it before replying or tagging so your agent reads the whole conversation.
Parameters
| Name | Type | Description |
|---|---|---|
| chat_id string required | string | Chat ID from list_chats or list_archived_chats. |
Request
curl https://cotlet.dev/api/v1/livechat/chats/chat_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("livechat", "get_chat", {"chat_id":"chat_8c41d2"}) const result = await cotlet.call('livechat', 'get_chat', {"chat_id":"chat_8c41d2"}); cotlet call livechat get_chat --data '{"chat_id":"chat_8c41d2"}' Example response
{
"chat_id": "PJ0MRSHTDG",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"tags": [],
"messages": [
{
"from": "customer",
"text": "Hi, I was charged twice in October.",
"sent_at": "2026-10-17T05:42:00Z"
},
{
"from": "customer",
"text": "Order 4821.",
"sent_at": "2026-10-17T05:43:00Z"
}
]
}