List calls
list_callsList calls. Call history, newest first: WhatsApp calls and the calls AI agents answered on the account's phone lines. A call is visible exactly when its conversation is: an administrator sees every call in the account, an agent only the calls of conversations their visibility setting lets them open. Filter by contact or conversation to show a customer's call history; pair with the call_started and call_ended webhooks to keep another system in step. To copy every call into another system, pass updated_since and then each response's meta.next_cursor as cursor until it is null: you get every call created or changed since, oldest change first. Requires feature: whatsapp_calling for WhatsApp calls, voice_agents for AI calls, voice_integrations for calls imported from your own voice workspace. An account sees the calls of the features it has.
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 |
|---|---|---|---|
| page | No | Page number, from 1. | |
| since | No | Calls created at or after this moment — an ISO 8601 timestamp, or a date (`YYYY-MM-DD`) for the start of that day. | |
| until | No | Calls created at or before this moment — an ISO 8601 timestamp, or a date for the end of that day. | |
| cursor | No | Sync mode. The `meta.next_cursor` from the previous response. | |
| fields | No | Optional: return only these fields of each record. | |
| status | No | One status, or several separated by commas. | |
| inbox_id | No | ||
| per_page | No | Calls per page. Values above 100 are treated as 100. | |
| direction | No | `incoming` or `outgoing` (`inbound` and `outbound` are accepted too). | |
| ai_handled | No | `true` for only the calls an AI agent answered, `false` for only the others. | |
| contact_id | No | ||
| agent_bot_id | No | Only the calls this AI agent answered. | |
| evaluation_id | No | An objective of the AI agents (its `id` in the AI call report's `options.evaluation_criteria`). Send it together with `evaluation_result`. | |
| updated_since | No | Sync mode. Only calls created or changed at or after this ISO 8601 timestamp, oldest change first. | |
| conversation_id | No | The conversation's display ID, as in conversation paths. | |
| evaluation_result | No | Only AI calls where the objective had this result. Send it together with `evaluation_id`; one without the other is refused with `invalid_evaluation`. |