Retrieve calls

View as Markdown

Voice Agent lists and retrieval return the same external payload used by Voice Agent webhooks. Transcription stays as complete text in transcript; analysis stays in inbuilt_analytics.

InputContract
time_fieldconversation_time only; this is the default.
start_time, end_timeRequired on lists: Unix epoch seconds, start inclusive and end exclusive, spanning at most 31 days.
agent_idOptional on lists. Omit it to include your account’s Voice Agents.
statusOptional native status filter: completed, call_initiated, or error.
filterOptional dashboard Voice Agent filters as one URL-encoded JSON object. Supports customer/conversation IDs, duration, direction, disconnect details, campaign, transfer, CRM and business insight filters. See the API reference for the complete field definitions.
limit, sort_order, cursorList-only: 1–50 records (default 20), asc/desc (default desc), and the next-page cursor.
conversation_idRequired path parameter for retrieval. No dates or include selector are needed.
Output fieldFormat
conversation_id, agent_idExisting Voice Agent and conversation identifiers.
conversation_timeConversation time in epoch seconds.
statusNative stored status, without renaming.
transcriptComplete original transcription text.
inbuilt_analyticsNative configured analysis modules and nested answers/explanations.
meta_analyticsWebhook metadata, including duration, disconnect outcome and recording_url when available.
tool_calls, future_schedulingNative tool and scheduling results when stored.
call_transfer_detailsExisting transfer status/details object.
request_dataStored integration request data.
telephony_provider_call_idProvider call identifier, when available.

Lists wrap records in data[] and return pagination metadata. Retrieval returns one record in data. Fields depend on the saved record and configured modules; unavailable source values may be absent or null.

For larger datasets, use Create export. It uses the existing Voice Agent CSV download code and returns a download link when ready. Each export supports at most 31 days, 100,000 records and 100 MB.