List calls
Calls from My Calls or Team Calls, newest first, with title, date, meeting type and open action items.
GET https://cotlet.dev/api/v1/fathom-video/calls
Lists calls the way the My Calls and Team Calls pages show them, newest first; pass next_cursor back as cursor for the next page. scope team_calls works for accounts on a Team plan. meeting_type filters by one of your Meeting Types, and created_after and created_before bound the date. open_action_items counts the items on the call that are not completed. Use call_id with the other tools.
Parameters
| Name | Type | Description |
|---|---|---|
| scope enum | enum | my_calls (default) or team_calls. |
| created_after date | date | Only calls recorded on or after this date. |
| created_before date | date | Only calls recorded before this date. |
| meeting_type string | string | Name of a Meeting Type, as shown on the call. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/fathom-video/calls \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("fathom-video", "list_calls") const result = await cotlet.call('fathom-video', 'list_calls'); cotlet call fathom-video list_calls Example response
{
"calls": [
{
"call_id": "610313346",
"title": "Q4 pricing review",
"recorded_at": "2026-10-21T15:00:00Z",
"meeting_type": "External",
"attendees": 4,
"open_action_items": 3,
"url": "https://fathom.video/calls/610313346"
},
{
"call_id": "610298114",
"title": "Vendor onboarding sync",
"recorded_at": "2026-10-20T09:30:00Z",
"meeting_type": "External",
"attendees": 3,
"open_action_items": 1,
"url": "https://fathom.video/calls/610298114"
}
],
"next_cursor": "c_2"
}