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

# Get Session

> Retrieve a session with its children and risk summary.

<Note>
  Requires `Authorization: Bearer` header with a deploy token (`qt_deploy_*`) or Supabase JWT.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>
  UUID of the session to retrieve.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Session UUID.
</ResponseField>

<ResponseField name="session_name" type="string">
  Human-readable session name.
</ResponseField>

<ResponseField name="model" type="string">
  LLM model used.
</ResponseField>

<ResponseField name="signing_id" type="string">
  Code signing identity of the agent process.
</ResponseField>

<ResponseField name="state" type="string">
  Current state: `active`, `idle`, `ended`.
</ResponseField>

<ResponseField name="platform" type="string">
  Agent platform identifier.
</ResponseField>

<ResponseField name="parent_id" type="string">
  Parent session UUID, or `null` for root sessions.
</ResponseField>

<ResponseField name="started_at" type="datetime">
  When the session began.
</ResponseField>

<ResponseField name="ended_at" type="datetime">
  When the session ended. `null` if still active.
</ResponseField>

<ResponseField name="children" type="array">
  Child sessions spawned from this session.
</ResponseField>

<ResponseField name="risk_summary" type="object">
  Aggregate risk statistics for this session.

  <Expandable title="risk_summary properties">
    <ResponseField name="total_events" type="integer">
      Total events in the session.
    </ResponseField>

    <ResponseField name="max_risk" type="integer">
      Highest risk score across events.
    </ResponseField>

    <ResponseField name="avg_risk" type="number">
      Average risk score across events.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.quintai.dev/v1/sessions/6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
    -H "Authorization: Bearer qt_deploy_YOUR_TOKEN"
  ```

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

  response = requests.get(
      "https://api.quintai.dev/v1/sessions/6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      headers={"Authorization": "Bearer qt_deploy_YOUR_TOKEN"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "session_name": "Fix auth middleware",
    "model": "claude-sonnet-4-20250514",
    "signing_id": "com.anthropic.claude-code",
    "state": "ended",
    "platform": "claude-code",
    "parent_id": null,
    "started_at": "2026-04-12T14:00:00Z",
    "ended_at": "2026-04-12T14:45:00Z",
    "children": [],
    "risk_summary": {
      "total_events": 47,
      "max_risk": 35,
      "avg_risk": 8
    }
  }
  ```
</ResponseExample>