Conversations
Retrieve a conversation
Retrieve details of a specific conversation including messages
GET
/
api
/
v2
/
conversations
/
{conversationId}
Copy
curl --request GET \
--url https://app.livechatai.com/api/v2/conversations/{conversationId} \
--header 'Authorization: Bearer <token>'
Copy
{
"status": "success",
"data": {
"id": "chat_1234567890",
"contactId": "contact_1234567890",
"agentId": "clx1234567890abcdef",
"isResolved": false,
"isAgent": false,
"isMuted": false,
"isStarred": false,
"integrationType": "WHATSAPP",
"lastMessageDate": "2024-01-20T14:45:00Z",
"agent": {
"id": "agent_1234567890",
"name": "Jane Smith",
"email": "jane@company.com",
"avatar": "https://example.com/avatar.jpg"
},
"messages": [
{
"id": "msg_1234567890",
"content": "What are your business hours?",
"role": "user",
"type": "TEXT",
"source": [
{
"id": "src_1234567890",
"type": "WEBSITE",
"link": "https://example.com/page",
"distance": 0.85
}
],
"agent": {
"id": "agent_1234567890",
"name": "Jane Smith",
"email": "jane@company.com",
"avatar": "https://example.com/avatar.jpg"
},
"createdAt": "2024-01-15T10:30:00Z"
}
],
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-20T14:45:00Z"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Unique identifier of the conversation to retrieve
Example:
"chat_1234567890"
Response
200
application/json
Successfully retrieved conversation details
The response is of type object
.
Copy
curl --request GET \
--url https://app.livechatai.com/api/v2/conversations/{conversationId} \
--header 'Authorization: Bearer <token>'
Copy
{
"status": "success",
"data": {
"id": "chat_1234567890",
"contactId": "contact_1234567890",
"agentId": "clx1234567890abcdef",
"isResolved": false,
"isAgent": false,
"isMuted": false,
"isStarred": false,
"integrationType": "WHATSAPP",
"lastMessageDate": "2024-01-20T14:45:00Z",
"agent": {
"id": "agent_1234567890",
"name": "Jane Smith",
"email": "jane@company.com",
"avatar": "https://example.com/avatar.jpg"
},
"messages": [
{
"id": "msg_1234567890",
"content": "What are your business hours?",
"role": "user",
"type": "TEXT",
"source": [
{
"id": "src_1234567890",
"type": "WEBSITE",
"link": "https://example.com/page",
"distance": 0.85
}
],
"agent": {
"id": "agent_1234567890",
"name": "Jane Smith",
"email": "jane@company.com",
"avatar": "https://example.com/avatar.jpg"
},
"createdAt": "2024-01-15T10:30:00Z"
}
],
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-20T14:45:00Z"
}
}
Assistant
Responses are generated using AI and may contain mistakes.