Skip to main content
GET
List Widget Conversations

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