Embed Widgets
List Widget Conversations
Paginated visitor sessions for a widget, with a one-line preview per session.
GET
List Widget Conversations
Authentication
Requires a Bearer token (API key) or a dashboard session.Path Parameters
string
required
The widget config UUID.
Query Parameters
number
default:"50"
Page size (max 200).
number
default:"0"
Number of sessions to skip.
string
ISO timestamp lower bound (inclusive).
string
ISO timestamp upper bound (inclusive).
string
true or false — filter by whether a lead was captured.string
active, completed, or all.Response
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.number
Total sessions matching the filter.
number
number
Example
curl
List Widget Conversations
