> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one conversation and its state

> Retrieve a conversation you own, or any of them if your role can moderate. One that is missing, in another organisation or hidden from you returns the same 404.

You can read a conversation you own. A caller whose role can moderate conversations (`owner` or `admin`) can read any conversation in the organization.

A conversation that does not exist, belongs to another organization, is not visible to you, or has a malformed ID all return the same `404`. The response never tells you which.

Reading a conversation also resolves its assistant. If that assistant can no longer answer (it is `disabled` or `archived`, or has no knowledge attached), this request returns `400` `validation_error`.

<ParamField path="conversation_id" type="string" required>
  The conversation ID.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  The conversation ID.
</ResponseField>

<ResponseField name="assistant_id" type="string" required>
  The assistant that answers in this conversation.
</ResponseField>

<ResponseField name="title" type="string" required>
  The conversation title.
</ResponseField>

<ResponseField name="status" type="string" required>
  `active` or `archived`.
</ResponseField>

<ResponseField name="turn_state" type="string" required>
  `idle`, or `awaiting_answer` while a question is being answered. You cannot ask a new question
  until it is `idle` again.
</ResponseField>

<ResponseField name="message_count" type="integer" required>
  The number of messages. Each question and each answer counts as one.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 creation timestamp with a UTC offset.
</ResponseField>

<ResponseField name="updated_at" type="string" required>
  ISO 8601 timestamp of the last change.
</ResponseField>

<ResponseField name="owner" type="object" required>
  An opaque reference to the owning participant.

  <Expandable title="properties">
    <ResponseField name="type" type="string">
      `user` for a signed-in person, `service` for an API key.
    </ResponseField>

    <ResponseField name="id" type="string">
      The owner's identifier.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object" required>
  Your metadata entries.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request GET "$MITHUNAI_URL/arukz/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/conversations/{conversation_id}",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
  const response = await fetch(
    `${process.env.MITHUNAI_URL}/arukz/api/v1/conversations/${conversationId}`,
    { headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` } },
  )
  console.log(await response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
    "assistant_id": "5b0e2c7a-91d4-4f3e-8a6b-2d7c9e1f4a38",
    "title": "How do I rotate an API key?",
    "status": "active",
    "turn_state": "idle",
    "message_count": 2,
    "created_at": "2026-09-24T10:15:02.184311+00:00",
    "updated_at": "2026-09-24T10:15:09.402117+00:00",
    "owner": { "type": "service", "id": "9a7d3e51-2f6c-4b88-a0d4-6e1b5c3f7a92" },
    "metadata": { "source": "support-portal" }
  }
  ```

  ```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "not_found", "message": "The requested resource was not found." }
  ```
</ResponseExample>