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

# Get Widget Conversation

> Full message transcript for a single widget session, including operator messages.

## Authentication

Requires a Bearer token (API key) or a dashboard session.

## Path Parameters

<ParamField path="id" type="string" required>
  The widget config UUID.
</ParamField>

<ParamField path="sessionId" type="string" required>
  The session UUID.
</ParamField>

## Response

<ResponseField name="session" type="object">
  Session metadata: `id`, `visitor_id`, `ip_country`, `city`, `page_url`, `referrer_url`, `started_at`, `ended_at`, `last_seen_at`, `message_count`, `lead_captured`, `lead_data`, `duration_seconds`, `takeover_status`, `taken_over_by`, `taken_over_at`, `last_operator_message_at`.
</ResponseField>

<ResponseField name="messages" type="array">
  Ordered transcript. Each message: `id`, `role` (`user`, `assistant`, or `operator`), `content`, `mode`, `resolved_mode`, `cost_cents`, `operator_user_id`, `created_at`.
</ResponseField>

## Example

```bash curl theme={null}
curl https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/conversations/SESSION_ID \
  -H "Authorization: Bearer $THEO_API_KEY"
```