Skip to main content

List Conversations

Retrieve a list of conversations for agents belonging to the authenticated user.
string
Filter conversations by agent ID
integer
default:"30"
Number of conversations to return per page (1-100)
string
Filter by call success status: ‘success’ or ‘failure’
integer
Filter conversations started before this Unix timestamp
integer
Filter conversations started after this Unix timestamp
string
Filter by user ID
string
default:"include"
Include summary in response: ‘include’ or ‘exclude’
string
Pagination cursor for next page

Response

object
Response status information
integer
HTTP status code (200)
string
Status message
array
Array of conversation objects
string
Unique conversation identifier
string
Associated agent ID
string
Name of the agent
string
Conversation status
array
Array of conversation transcript entries
object
Additional conversation metadata
string
ISO 8601 timestamp when conversation started
integer
Total number of conversations matching the query
string
Pagination cursor for the next page
boolean
Whether there are more results available

Pagination

Use the cursor field from the response to fetch the next page:

Error Responses

object
Unauthorized - Invalid or missing authentication
object
Bad request - Missing API key or invalid parameters
object
Bad gateway - ElevenLabs API error