While dashboard APIs provide aggregated metrics, the Conversation Insights endpoint allows you to drill down into specific interactions your agent has had with users, retrieving full transcripts, audio playbacks, and LLM-generated summaries.
Fetch Conversations
Use the /agent-conversation/ endpoint to retrieve paginated lists of historical sessions.
cURL
Query Parameters
| Parameter | Type | Description |
|---|---|---|
agent_uuid (path) | string | ID of the agent to query |
skip | integer | Records to skip (default: 0) |
limit | integer | Results per page (default: 10) |
status | string | Filter by call status (e.g., completed) |
disposition | string | Filter by call outcome |
start_date | string | Filter by start date (YYYY-MM-DD) |
end_date | string | Filter by end date (YYYY-MM-DD) |
Conversation Metrics
Retrieve high-level metrics and counts for all conversations associated with an agent.
cURL
Exporting Data
For offline analysis or compliance requirements, you can download interaction data in bulk.
Download CSV
Use the /download-agent-conversation-csv/ endpoint to
receive a direct CSV download of the conversation metadata.
Audio S3 URLs
Generate presigned S3 URLs using the /get-presigned-s3-url/
endpoint to securely playback recordings.
Last updated: March 2026
Last modified on