---
title: "Get a chat"
method: GET
path: "/chat/{chat_id}"
tags: ["chat"]
---

# Get a chat

`GET /chat/{chat_id}`

Retrieve details of a specific chat session.

## Path parameters

- `chat_id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

200

- ChatGetChatResponse200
  - `status` string — Whether the request was successful.
  - `response` ChatResponse — Chat session details.
    - `chat_id` string, uuid, required — Unique identifier for the chat session.
    - `chat_status` 'ongoing' | 'completed' | 'cancelled', required — Current status of the chat session.
    - `conversation_history` ChatMessage[], required — List of messages in the conversation.
      - `agent_id` string, required — ID of the agent (or 'user' for user messages).
      - `current_state` string, required — The current state of the agent when this message was sent.
      - `message` string, required — The message content.
      - `timestamp` string, date-time, required — ISO 8601 timestamp of when the message was sent.
      - `turn_number` integer, required — The turn number in the conversation.
    - `initial_message` ChatResponseInitialMessage — The initial message sent by the agent when the chat was created.
      - `agent_message` string — The message content from the agent.
      - `current_state` string — The current state of the agent.
      - `timestamp` string, date-time — ISO 8601 timestamp of when the message was sent.
      - `turn_number` integer — The turn number in the conversation.
    - `start_timestamp` string, date-time, required — ISO 8601 timestamp of when the chat session started.
    - `transcript` string, required — Full transcript of the conversation.
    - `fsm_log` object, nullable — Finite State Machine (FSM) execution log for the chat session.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)