> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/api-documentation/chat/conversation/get-a-conversation.md).

# Get a conversation

Returns a conversation with its labels, pipeline stage, collaborators, and the last message from the contact side and from a human agent.

```json
{"openapi":"3.0.3","info":{"title":"Cekat Open API","version":"1.0.0"},"tags":[{"name":"Conversation","description":"A conversation is the chat thread between one contact and one of your inboxes. Use these endpoints to list conversations, read one in detail, see which human agent handled each one, and change the AI agent that replies."}],"servers":[{"url":"https://api.cekat.ai","description":"Production"}],"security":[{"CekatApiKey":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"CekatApiKey":{"type":"apiKey","in":"header","name":"api_key","description":"Your business's Cekat API key, from **Settings → Developers & API** in the Cekat dashboard (https://chat.cekat.ai/developers?section=apikeys). Available on the Business and Enterprise plans."},"BearerAuth":{"type":"http","scheme":"bearer","description":"The same Cekat API key, sent as `Authorization: Bearer YOUR_API_KEY`. Accepted only by endpoints under `/api/...`."}},"schemas":{"ConversationDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"stage_status":{"type":"string","enum":["open","pending","assigned","resolved"]},"notes":{"type":"string","nullable":true},"labels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"color":{"type":"string"}}}},"pipeline":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"collaborators":{"type":"array","description":"Agents added to the conversation as collaborators.","items":{"$ref":"#/components/schemas/NamedRef"}},"inbox_id":{"type":"string","format":"uuid"},"inbox_name":{"type":"string"},"platform_type":{"type":"string"},"contact_id":{"type":"string","format":"uuid"},"contact_name":{"type":"string"},"contact_phone":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"resolved_at":{"type":"string","format":"date-time","nullable":true},"handled_by_id":{"type":"string","format":"uuid","nullable":true},"handled_by_name":{"type":"string","nullable":true},"resolved_by_id":{"type":"string","format":"uuid","nullable":true},"resolved_by_name":{"type":"string","nullable":true},"additional_data":{"type":"object","nullable":true,"additionalProperties":true},"first_message":{"type":"object","properties":{"message":{"type":"string"}}},"last_message":{"type":"object","properties":{"message":{"type":"string"},"created_at":{"type":"string","format":"date-time","nullable":true},"sent_by_type":{"type":"string","description":"Who sent the last message."}}},"last_message_by_human":{"type":"object","nullable":true,"description":"The last message sent by a human agent, if any.","properties":{"message":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"sent_by_type":{"type":"string"}}}}},"NamedRef":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"ApiError":{"type":"object","description":"Error body returned by the `/api/...` endpoints.","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"statusCode":{"type":"integer"},"error":{"type":"object","properties":{"message":{"type":"string"}}},"correlationId":{"type":"string","description":"Request ID. Include it when contacting Cekat support."}}},"RateLimitError":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"ApiBadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"ApiUnauthorized":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"ApiNotFound":{"description":"The resource was not found or does not belong to your business.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"TooManyRequests":{"description":"Rate limit exceeded. Wait and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/conversations/{conversation_id}":{"get":{"tags":["Conversation"],"operationId":"GetConversation","summary":"Get a conversation","description":"Returns a conversation with its labels, pipeline stage, collaborators, and the last message from the contact side and from a human agent.","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The conversation.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/ConversationDetail"}}}}}},"400":{"$ref":"#/components/responses/ApiBadRequest"},"401":{"$ref":"#/components/responses/ApiUnauthorized"},"404":{"$ref":"#/components/responses/ApiNotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}}}
```