Skip to main content
GET
/
api
/
v1
/
iframes
/
{id}
/
conversations
/
{sessionId}
Get Widget Conversation
curl --request GET \
  --url https://api.example.com/api/v1/iframes/{id}/conversations/{sessionId}
{
  "session": {},
  "messages": [
    {}
  ]
}

​
Authentication

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

​
Path Parameters

​
id
string
required
The widget config UUID.
​
sessionId
string
required
The session UUID.

​
Response

​
session
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.
​
messages
array
Ordered transcript. Each message: id, role (user, assistant, or operator), content, mode, resolved_mode, cost_cents, operator_user_id, created_at.

​
Example

curl
curl https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/conversations/SESSION_ID \
  -H "Authorization: Bearer $THEO_API_KEY"