List Recaps | Calendly | Developer Documentation

const url = 'https://api.calendly.com/meeting_recaps?end_time=2025-11-10T23%3A59%3A59Z&start_time=2025-11-01T00%3A00%3A00Z';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "collection": [
    {
      "uri": "https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB",
      "status": "available",
      "transcript": "https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB/transcript",
      "event": "https://api.calendly.com/scheduled_events/AAAAAAAAAAAAAAAA",
      "name": "Weekly Sync",
      "location": {
        "location": "https://zoom.us/j/123456789",
        "type": "custom"
      },
      "start_time": "2025-11-08T20:28:00.561000Z",
      "end_time": "2025-11-08T21:28:00.561000Z",
      "created_at": "2025-11-08T19:00:00.000000Z",
      "updated_at": "2025-11-08T22:00:00.000000Z",
      "attendees": [
        {
          "host": true,
          "user_email": "john@example.com",
          "user_name": "John Smith"
        },
        {
          "host": false,
          "user_email": "steve@example2.com",
          "user_name": "Steve Johnson"
        }
      ]
    },
    {
      "uri": "https://api.calendly.com/meeting_recaps/CCCCCCCCCCCCCCCC",
      "status": "available",
      "transcript": "https://api.calendly.com/meeting_recaps/CCCCCCCCCCCCCCCC/transcript",
      "event": null,
      "name": "External standup",
      "location": {
        "location": "https://meet.google.com/abc-defg-hij",
        "type": "custom"
      },
      "start_time": "2025-11-07T15:00:00.000000Z",
      "end_time": "2025-11-07T15:30:00.000000Z",
      "created_at": "2025-11-07T14:00:00.000000Z",
      "updated_at": "2025-11-07T15:45:00.000000Z",
      "attendees": null
    }
  ],
  "pagination": {
    "count": 2,
    "next_page": null,
    "previous_page": null,
    "next_page_token": null,
    "previous_page_token": null
  }
}

Returns a paginated list of meeting recaps accessible to the authenticated user. By default, returns Available recaps only. Use the status query parameter to retrieve processing or unavailable recaps. Supports additional filtering by scheduled event, attendee, or date range.

Returns both Calendly-scheduled and external event recaps in a single collection. The event field is null for external events where no Calendly scheduled event exists.

Note: Requires paid plan

Required scopes

meeting_recaps:read

Returns a paginated list of meeting recaps accessible to the authenticated user. By default, returns **Available** recaps only. Use the `status` query parameter to retrieve `processing` or `unavailable` recaps. Supports additional filtering by scheduled event, attendee, or date range. Returns both Calendly-scheduled and external event recaps in a single collection. The `event` field is null for external events where no Calendly scheduled event exists. **Note:** Requires paid plan <Info title="Required scopes"> > `meeting_recaps:read` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Query parameters

eventstringOptionalformat: "uri"

Filter results to recaps associated with a specific event scheduled via Calendly. This field corresponds to the /scheduled_events endpoint.

start_timestringOptionalformat: "date-time"

Return recaps for meetings that end after (or end at) this time (ISO 8601).

end_timestringOptionalformat: "date-time"

Return recaps for meetings that start before (or start at) this time (ISO 8601).

statusenumOptional

Filter by recap availability. When omitted, returns Available recaps only.

available — completed recaps with summary content
processing — recaps still being generated
unavailable — recaps that cannot be retrieved

Filter by recap availability. When omitted, returns **Available** recaps only. - `available` — completed recaps with summary content - `processing` — recaps still being generated - `unavailable` — recaps that cannot be retrieved

Allowed values:

attendeestringOptionalformat: "email"

Filter results to recaps that include a specific attendee email address.

countintegerOptional1-100Defaults to 20

The number of rows to return

page_tokenstringOptional

The token to pass to get the next or previous portion of the collection

Response

collectionlist of objects

The set of meeting recaps matching the criteria

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error