> Calendly developer docs. For page Markdown, append .md to any URL. > Index: https://developer.calendly.com/llms.txt > API catalog: https://developer.calendly.com/.well-known/api-catalog > OpenAPI: https://developer.calendly.com/openapi/calendly-api.yaml > OAuth authorization server: https://calendly.com/.well-known/oauth-authorization-server > MCP protected resource: https://mcp.calendly.com/.well-known/oauth-protected-resource > Scheduling MCP endpoint: https://mcp.calendly.com > Docs search MCP: https://developer.calendly.com/_mcp/server # List Recaps GET https://api.calendly.com/meeting_recaps 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 > `meeting_recaps:read` Reference: https://developer.calendly.com/api-docs/calendly-api/notetaker/list-meeting-recaps ## Authentication - `Authorization` header (bearer token, required) — OAuth 2.0 - `Authorization` header (bearer token, required) — Personal Access Token ## Request ### Query parameters - `event` (string, optional) — Filter results to recaps associated with a specific event scheduled via Calendly. This field corresponds to the `/scheduled_events` endpoint. - `start_time` (string, optional) — Return recaps for meetings that end after (or end at) this time (ISO 8601). - `end_time` (string, optional) — Return recaps for meetings that start before (or start at) this time (ISO 8601). - `status` (enum, optional) — 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: `available`, `processing`, `unavailable` - `attendee` (string, optional) — Filter results to recaps that include a specific attendee email address. - `count` (integer, optional, default: 20) — The number of rows to return - `page_token` (string, optional) — The token to pass to get the next or previous portion of the collection ## Response ### 200 OK - `collection` (list of MeetingRecapListItem, required) — The set of meeting recaps matching the criteria - `pagination` (Pagination, required) ## Errors ### 400 Bad Request Error Request is not valid - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 401 Unauthorized Error Cannot authenticate caller - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 403 Forbidden Error Permission Denied or insufficient scope - `List-meeting-recapsRequestForbiddenError` ### 404 Not Found Error Requested resource not found - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ### 500 Internal Server Error An error has occurred on the server - `title` (enum, required) - Allowed values: `Internal Server Error` - `message` (enum, required) - Allowed values: `The server encountered an unexpected condition that prevented it from fulfilling the request.` - `details` (list of ErrorResponseDetailsItem, optional) ## Types ### MeetingRecapListItem A meeting recap list item generated for a Calendly scheduled event or an external event. - `uri` (string, required) — Canonical reference (unique identifier) for the recap. - `app_url` (string, required) — URL for an authorized Calendly user to open this meeting recap in the Calendly web app. Requires authentication and access to the recap. - `status` (string, required) — Processing state of the recap. - `transcript` (string, required) — Canonical reference (unique identifier) for the transcript. Always present on list items; the transcript resource itself may still be unavailable until the recap is Available. - `event` (string, optional, nullable) — URI of the event scheduled via Calendly which this recap belongs to, or null if the recap is for an external event. - `name` (string, optional, nullable) — Name of the meeting. - `location` (Location, optional) — The polymorphic base type for an event location that Calendly supports - `start_time` (string, optional, nullable) — Scheduled start time of the meeting (UTC, ISO 8601). - `end_time` (string, optional, nullable) — Scheduled end time of the meeting (UTC, ISO 8601). - `created_at` (string, optional, nullable) — When the tracked meeting record was created (UTC, ISO 8601). - `updated_at` (string, optional, nullable) — When the tracked meeting record was last updated (UTC, ISO 8601). - `attendees` (list of MeetingRecapListItemAttendeesItems, optional, nullable) — Meeting attendees derived from tracked-meeting participants. Same shape as meeting_recap webhook attendees. ### Pagination - `count` (integer, required) — The number of rows to return - `next_page` (string, required, nullable) — URI to return the next page of an ordered list ("null" indicates no additional results are available) - `previous_page` (string, required, nullable) — URI to return the previous page of an ordered list ("null" indicates no additional results are available) - `next_page_token` (string, required, nullable) — Token to return the next page of an ordered list ("null" indicates no additional results are available) - `previous_page_token` (string, required, nullable) — Token to return the previous page of an ordered list ("null" indicates no additional results are available) ### ErrorResponseDetailsItem - `message` (string, required) - `parameter` (string, optional) - `code` (string, optional) ### MeetingRecapsError Permission Denied - `title` (enum, required) - Allowed values: `Permission Denied` - `message` (enum, required) - Allowed values: `Please upgrade to a paid Calendly account`, `You do not have permission to access this resource`, `Meeting recap access is not available. Required features are not enabled for your account` ### InsufficientScopeError Caller does not have required oauth scopes - `title` (enum, required) - Allowed values: `Insufficient scope` - `message` (enum, required) - Allowed values: `This operation requires the scopes listed in the 'required_scopes' array.` - `required_scopes` (list of string, required) ### Location The polymorphic base type for an event location that Calendly supports ### MeetingRecapListItemAttendeesItems - `host` (boolean, required) — Whether this attendee is the meeting host. - `user_email` (string, required) — Attendee email address. - `user_name` (string, required) — Attendee display name. ### InPersonMeeting Information about the physical (in-person) event location - `type` (enum, required) — Indicates that the event will be an in-person meeting. - Allowed values: `physical` - `location` (string, required) — The physical location specified by the event host (publisher) - `additional_info` (string, optional) ### OutboundCall Meeting publisher will call the Invitee - `type` (enum, required) — Indicates that the event host (publisher) will call the invitee - Allowed values: `outbound_call` - `location` (string, required, nullable) — The phone number the event host (publisher) will use to call the invitee ### InboundCall Invitee will call meeting publisher at the specified phone number - `type` (enum, required) — Indicates that the invitee will call the event host - Allowed values: `inbound_call` - `location` (string, required) — The phone number the invitee will use to call the event host (publisher) - `additional_info` (string, optional) ### GoogleConference Details about an Event that will take place using a Google Meet / Hangout conference. Location details will not be available 6 months after event has occurred. - `type` (enum, required) — The event location is a Google Meet or Hangouts conference - Allowed values: `google_conference` - `status` (enum, required, nullable) — Indicates the current status of the Google conference \* Expect only `pushed` status to have a non-`null` value for the `join_url` field. - `processing` Location details generation pending - `initiated` Requesting location details from Google - `pushed` Location details are available - `failed` Error occurred or event has been canceled - `null` Location details are no longer available - Allowed values: `processing`, `initiated`, `pushed`, `failed` - `join_url` (string, required, nullable) — Google conference meeting url ### ZoomConference Meeting will take place in a Zoom conference. Location details will not be available 6 months after event has occurred. - `type` (enum, required) — The event location is a Zoom conference - Allowed values: `zoom` - `status` (enum, required, nullable) — Indicates the current status of the Zoom conference \* Expect only `pushed` status to have non-`null` values for `join_url` & `data` fields. - `processing` Location details generation pending - `initiated` Requesting location details from Zoom - `pushed` Location details are available - `failed` Error occurred or event has been canceled - `null` Location details are no longer available - Allowed values: `processing`, `initiated`, `pushed`, `failed` - `join_url` (string, required, nullable) — Zoom meeting url - `data` (ZoomConferenceData, required, nullable) — The conference metadata supplied by Zoom ### GotoMeetingConference Details about an Event that will take place using a GotoMeeting conference. Location details will not be available 6 months after event has occurred. - `type` (enum, required) — The event location is a GoToMeeting conference - Allowed values: `gotomeeting` - `status` (enum, required, nullable) — Indicates the current status of the GoToMeeting conference \* Expect only `pushed` status to have non-`null` values for `join_url` & `data` fields. - `processing` Location details generation pending - `initiated` Requesting location details from GoToMeeting - `pushed` Location details are available - `failed` Error occurred or event has been canceled - `null` Location details are no longer available - Allowed values: `initiated`, `processing`, `pushed`, `failed` - `join_url` (string, required, nullable) — GoToMeeting conference meeting url - `data` (GotoMeetingConferenceData, required, nullable) — The conference metadata supplied by GoToMeeting ### MicrosoftTeamsConference Meeting will take place in a Microsoft Teams conference. Location details will not be available 6 months after event has occurred. - `type` (enum, required) — The event location is a Microsoft Teams conference - Allowed values: `microsoft_teams_conference` - `status` (enum, required, nullable) — Indicates the current status of the Microsoft Teams conference \* Expect only `pushed` status to have non-`null` values for `join_url` & `data` fields. - `processing` Location details generation pending - `initiated` Requesting location details from MS Teams - `pushed` Location details are available - `failed` Error occurred or event has been canceled - `null` Location details are no longer available - Allowed values: `processing`, `initiated`, `pushed`, `failed` - `join_url` (string, required, nullable) — Microsoft Teams meeting url - `data` (MicrosoftTeamsConferenceData, required, nullable) — The conference metadata supplied by Microsoft Teams ### CustomLocation Use this to describe an existing Calendly-supported event location. - `type` (enum, required) — The event location doesn't fall into a standard category defined by the event host (publisher) - Allowed values: `custom` - `location` (string, required, nullable) — The location description provided by the event host (publisher) ### InviteeSpecifiedLocation Information about an event location that’s specified by the invitee. - `type` (enum, required) — The event location selected by the invitee - Allowed values: `ask_invitee` - `location` (string, required) — The event location description provided by the invitee ### WebExConference Details about an Event that will take place using a WebEx conference. Location details will not be available 6 months after event has occurred. - `type` (enum, required) — The event location is a WebEx conference - Allowed values: `webex_conference` - `status` (enum, required, nullable) — Indicates the current status of the WebEx conference \* Expect only `pushed` status to have non-`null` values for `join_url` & `data` fields. - `processing` Location details generation pending - `initiated` Requesting location details from WebEx - `pushed` Location details are available - `failed` Error occurred or event has been canceled - `null` Location details are no longer available - Allowed values: `processing`, `initiated`, `pushed`, `failed` - `join_url` (string, required, nullable) — WebEx conference meeting url - `data` (WebExConferenceData, required, nullable) — The conference metadata supplied by GoToMeeting ### ZoomConferenceData The conference metadata supplied by Zoom - `id` (ZoomConferenceDataId, optional) — The conference ID provided by Zoom - `settings` (ZoomConferenceDataSettings, optional) - `extra` (ZoomConferenceDataExtra, optional) - `password` (string, optional) — Zoom meeting password ### GotoMeetingConferenceData The conference metadata supplied by GoToMeeting - `uniqueMeetingId` (double, optional) — Canonical reference (unique identifier) for the GoToMeeting conference - `conferenceCallInfo` (string, optional) ### MicrosoftTeamsConferenceData The conference metadata supplied by Microsoft Teams - `id` (string, optional) — The conference ID provided by Microsoft Teams - `audioConferencing` (MicrosoftTeamsConferenceDataAudioConferencing, optional, nullable) ### WebExConferenceData The conference metadata supplied by GoToMeeting - `id` (string, required) — Canonical reference (unique identifier) for the WebEx conference - `telephony` (WebExConferenceDataTelephony, required) - `password` (string, required) ### ZoomConferenceDataId The conference ID provided by Zoom ### ZoomConferenceDataSettings - `global_dial_in_numbers` (list of ZoomConferenceDataSettingsGlobalDialInNumbersItems, optional) ### ZoomConferenceDataExtra - `intl_numbers_url` (string, optional) — Zoom International Dial-in Numbers URL ### MicrosoftTeamsConferenceDataAudioConferencing - `conferenceId` (string, optional) - `dialinUrl` (string, optional) - `tollNumber` (string, optional) ### WebExConferenceDataTelephony - `callInNumbers` (list of WebExConferenceDataTelephonyCallInNumbersItems, required) ### ZoomConferenceDataSettingsGlobalDialInNumbersItems - `number` (string, optional) — Phone number - `country` (string, optional) — Country code - `type` (string, optional) - `city` (string, optional) - `country_name` (string, optional) ### WebExConferenceDataTelephonyCallInNumbersItems - `label` (string, required) - `callInNumber` (string, required) - `tollType` (string, required) ## Examples **Response** ```json { "collection": [ { "uri": "https://api.calendly.com/meeting_recaps/BBBBBBBBBBBBBBBB", "app_url": "https://calendly.com/app/tracked_meetings/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", "app_url": "https://calendly.com/app/tracked_meetings/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 } } ``` **SDK Code** ```python Meeting recaps import requests url = "https://api.calendly.com/meeting_recaps" querystring = {"attendee":"bob@example.com","end_time":"2025-11-10T23:59:59Z","event":"https://api.calendly.com/scheduled_events/AAAAAAAAAAAAAAAA","start_time":"2025-11-01T00:00:00Z"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Meeting recaps const url = 'https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Meeting recaps package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Meeting recaps require 'uri' require 'net/http' url = URI("https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Meeting recaps import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z") .header("Authorization", "Bearer ") .asString(); ``` ```php Meeting recaps request('GET', 'https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Meeting recaps using RestSharp; var client = new RestClient("https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Meeting recaps import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.calendly.com/meeting_recaps?attendee=bob%40example.com&end_time=2025-11-10T23%3A59%3A59Z&event=https%3A%2F%2Fapi.calendly.com%2Fscheduled_events%2FAAAAAAAAAAAAAAAA&start_time=2025-11-01T00%3A00%3A00Z")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```