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

# Get Topic

> Get a topic with all commentaries and status summary

## Path Parameters

<ParamField path="id" type="string" required>
  Topic UUID returned from `POST /topics`
</ParamField>

## Response

<ResponseField name="topic_id" type="string">
  Topic identifier.
</ResponseField>

<ResponseField name="content" type="string">
  The topic content.
</ResponseField>

<ResponseField name="status" type="string">
  Overall status: `pending`, `in_progress`, `partial`, `completed`
</ResponseField>

<ResponseField name="commentaries" type="array">
  Array of commentary objects for each persona.
</ResponseField>

<ResponseField name="summary" type="object">
  Progress summary with `total_personas`, `completed`, `pending`, `failed`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
    -H "X-Api-Key: pk_live_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890',
    { headers: { 'X-Api-Key': 'pk_live_your_api_key' } }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://prod.api.unleeshed.ai/partner/v1/topics/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      headers={"X-Api-Key": "pk_live_your_api_key"}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "data": {
      "topic_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": "Should the Lakers trade Anthony Davis before the deadline?",
      "status": "completed",
      "created_at": "2026-01-30T15:30:00Z",
      "commentaries": [
        {
          "persona_id": "persona-abc-123",
          "persona_name": "Coach Mike",
          "persona_image": "https://storage.unleeshed.ai/personas/coach-mike.jpg",
          "status": "completed",
          "commentary": {
            "id": "comm-111-...",
            "content": "Look, AD is still one of the best two-way players...",
            "audio_url": null,
            "video_url": null
          }
        },
        {
          "persona_id": "persona-xyz-789",
          "persona_name": "Sports Analyst Sarah",
          "persona_image": "https://storage.unleeshed.ai/personas/sarah.jpg",
          "status": "completed",
          "commentary": {
            "id": "comm-222-...",
            "content": "From a pure analytics standpoint...",
            "audio_url": null,
            "video_url": null
          }
        }
      ],
      "summary": {
        "total_personas": 2,
        "completed": 2,
        "pending": 0,
        "failed": 0
      }
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "success": false,
    "error": {
      "code": "not_found",
      "message": "Topic not found"
    }
  }
  ```
</ResponseExample>