List calls
Calls of your account for a period, newest first, with direction, state, duration, contact and tags.
MCP tool ringover_read → list_calls
read
Lists calls from the call log, newest first, one page at a time; pass next_cursor back as cursor for the next page. status filters by the call state: answered, missed or voicemail. direction is incoming or outgoing. duration_seconds is the talk time, 0 for a call nobody answered. Calls follow what your Ringover user can see in the call logs. call_id goes into get_call and get_call_transcript.
Parameters
| Name | Type | Description |
|---|---|---|
| from datetime | datetime | Calls that started at or after this time (ISO 8601). |
| to datetime | datetime | Calls that started before this time (ISO 8601). |
| status enum | enum | answered, missed or voicemail. Default: all. |
| direction enum | enum | incoming or outgoing. Default: both. |
| limit integer | integer | How many calls per page. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ringover_read",
"arguments": {
"operation": "list_calls",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"calls": [
{
"call_id": "c_91e04a77",
"direction": "incoming",
"status": "answered",
"started_at": "2026-10-22T09:14:00Z",
"duration_seconds": 412,
"contact": "Dana Whitfield",
"number": "+15550100142",
"user": "Sam Reyes",
"tags": []
},
{
"call_id": "c_91e04a80",
"direction": "incoming",
"status": "missed",
"started_at": "2026-10-22T09:31:00Z",
"duration_seconds": 0,
"contact": null,
"number": "+15550100177",
"user": null,
"tags": []
}
],
"next_cursor": "eyJwIjoyfQ"
},
"isError": false
}