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

read

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

Parameters: list_calls
NameTypeDescription
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
curl https://cotlet.dev/api/v1/fathom-video/calls \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("fathom-video", "list_calls")
Node.js
const result = await cotlet.call('fathom-video', 'list_calls');
CLI
cotlet call fathom-video list_calls

Example response

JSON

{
  "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"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.