list_calls
Retrieve recent call logs filtered by agent, number, status, direction, or search to review call summaries and details.
Instructions
List recent calls. Scope by agent_id or number_id, or use status/direction/search to filter globally.
When agent_id or number_id is passed, status/direction/search filters are not applied. Returns call summaries including each call's ID, direction, participants, and status.
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": "list_calls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return | |
| offset | No | Number of results to skip (for pagination) | |
| search | No | Search by phone number or keyword | |
| status | No | Filter by status: ringing, in-progress, completed, failed, busy, no-answer | |
| agent_id | No | Filter to calls for a specific agent | |
| direction | No | Filter by direction: 'inbound' or 'outbound' | |
| number_id | No | Filter to calls for a specific phone number |