Query parameters
text_query string Required
The search query text for full-text and fuzzy matching
agent_id string or null Optional
The id of the agent you're taking the action on.
call_successful enum or null Optional
The result of the success evaluation
Allowed values: success failure unknown
call_start_before_unix integer or null Optional
Unix timestamp (in seconds) to filter conversations up to this start date.
call_start_after_unix integer or null Optional
Unix timestamp (in seconds) to filter conversations after to this start date.
call_duration_min_secs integer or null Optional
Minimum call duration in seconds.
call_duration_max_secs integer or null Optional
Maximum call duration in seconds.
rating_max integer or null Optional 1-5
Maximum overall rating (1-5).
rating_min integer or null Optional 1-5
Minimum overall rating (1-5).
user_id string or null Optional
Filter conversations by the user ID who initiated them.
evaluation_params list of strings or null Optional
Evaluation filters. Repeat param. Format: criteria_id:result. Example: eval=value_framing:success
data_collection_params list of strings or null Optional
Data collection filters. Repeat param. Format: id:op:value where op is one of eq|neq|gt|gte|lt|lte|in|exists|missing. For in, pipe-delimit values.
tool_names list of strings or null Optional
Filter conversations by tool names used during the call.
tool_names_successful list of strings or null Optional
Filter conversations by tool names that had successful calls.
tool_names_errored list of strings or null Optional
Filter conversations by tool names that had errored calls.
main_languages list of strings or null Optional
Filter conversations by detected main language (language code).
page_size integer Optional 1-50Defaults to 20
Number of results per page. Max 50.
summary_mode enum Optional Defaults to exclude
Whether to include transcript summaries in the response.
Allowed values: exclude include
conversation_initiation_source enum or null Optional Defaults to unknown
Enum representing the possible sources for conversation initiation.
branch_id string or null Optional
Filter conversations by branch ID.
sort_by enum Optional
Sort order for search results. ‘search_score’ sorts by search score, ‘created_at’ sorts by conversation start time.
Allowed values: search_score created_at
cursor string or null Optional
Used for fetching next page. Cursor is returned in the response.
Response Successful Response
has_more boolean
Whether there are more results available
next_cursor string or null
Cursor for the next page of results
