List calls
list_callsRead-onlyIdempotent
List calls. WhatsApp call history, newest first. 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. Requires feature: whatsapp_calling.
Input Schema
TableJSON 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. | |
| 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). | |
| contact_id | No | ||
| conversation_id | No | The conversation's display ID, as in conversation paths. |