Skip to main content
GET
/
api
/
v1
/
iframes
/
{id}
/
conversations
List Widget Conversations
curl --request GET \
  --url https://api.example.com/api/v1/iframes/{id}/conversations
{
  "conversations": [
    {}
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

​
Authentication

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

​
Path Parameters

​
id
string
required
The widget config UUID.

​
Query Parameters

​
limit
number
default:"50"
Page size (max 200).
​
offset
number
default:"0"
Number of sessions to skip.
​
from
string
ISO timestamp lower bound (inclusive).
​
to
string
ISO timestamp upper bound (inclusive).
​
has_lead
string
true or false — filter by whether a lead was captured.
​
status
string
active, completed, or all.

​
Response

​
conversations
array
Each session: session_id, visitor_id, ip_country, city, page_url, started_at, ended_at, last_seen_at, message_count, lead_captured, lead_data, first_message (preview), duration_seconds, referrer_url, takeover_status.
​
total
number
Total sessions matching the filter.
​
limit
number
​
offset
number

​
Example

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