List conversation history
Calls and assistant email conversations in your workspace, globally sorted by latest activity. Failed outbound call rows include the provider-neutral failure object. Every inbound and outbound email turn with the same stable thread_id is grouped into one conversation row. Email reply states are normalized to the shared statuses (pending → in_progress, replied/outbound → completed). Required scope: calls:read.
Authorizations
API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access.
Query Parameters
Filter by conversation type. avatar = web voice with virtual avatar; live_chat = widget text chat; messaging platforms query messaging conversations.
call, avatar, email, live_chat, whatsapp_voice, whatsapp, telegram, slack, messenger, teams, discord, gchat, x Filter by direction. web applies only to calls.
inbound, outbound, web queued, ringing, in_progress, completed, failed, no_answer, busy, skipped Filter calls and emails by assistant.
Filter by campaign; campaign history contains calls only.
Filter the unified history by one Audience contact across calls, messaging and email.
Search phone numbers, email addresses, email subject/body, and call summaries.
Only entries active at or after this ISO 8601 date/datetime (latest message time for email threads).
Only entries active at or before this ISO 8601 date/datetime (latest message time for email threads).
Page size (1–200).
1 <= x <= 200Number of items to skip.
x >= 0