retell_list_calls
List and filter calls in your Retell AI account by agent, status, or date range. Use pagination to retrieve large result sets.
Instructions
List calls in your Retell AI account. Supports filtering by agent ID, status, and date range. Supports pagination via pagination_key.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "retell_list_calls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of calls to return (1–1000). | |
| sort_order | No | Sort order by start timestamp. | |
| pagination_key | No | Pagination cursor from a previous response. Pass this to get the next page of results. | |
| filter_criteria | No | Optional filter criteria. |