List Calls
Retrieves calls from Retell AI.
Query
Only retrieve calls that are made with specific agent(s).
Only retrieve calls with specific batch call id(s).
Only retrieve calls with specific call status(es).
Only retrieve calls with specific call successful(s).
Only retrieve calls with specific call type(s).
Only retrieve calls with specific direction(s).
Only retrieve calls with specific disconnection reason(s).
Filter criteria for the calls to retrieve.
Only retrieve calls with specific from number(s).
Only retrieve calls that are in voicemail or not in voicemail.
Only retrieve calls with specific to number(s).
Only retrieve calls with specific user sentiment(s).
The version of the agent to use for the call.
Only retrieve calls with specific range of start timestamp(s).
Only retrieve calls with specific range of end timestamp(s).
Only retrieve calls with specific range of duration(s).
Filter by metadata fields using dot notation (e.g., `metadata.customer_id`). Values are matched exactly as strings.
Filter by dynamic variables using dot notation (e.g., `dynamic_variables.name`). Values are matched exactly as strings.
The calls will be sorted by `start_timestamp`, whether to return the calls in ascending or descending order. Allowed values: ascending, descending.
Limit the number of calls returned. Default 50, Max 1000. To retrieve more than 1000, use pagination_key to continue fetching the next page.
The pagination key to continue fetching the next page of calls. Pagination key is represented by a call id here, and it's exclusive (not included in the fetched calls). The last call id from the list calls is usually used as pagination key here. If not set, will start from the beginning.
Comma-separated response fields to include.