List calls
Calls of your account for a period, newest first, with direction, state, duration, contact and tags.
GET https://cotlet.dev/api/v1/ringover/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. |
Request
curl https://cotlet.dev/api/v1/ringover/calls \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("ringover", "list_calls")const result = await cotlet.call('ringover', 'list_calls');cotlet call ringover list_callsExample response
{
"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"
}