> ## Documentation Index > Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt > Use this file to discover all available pages before exploring further. # List meetings > Lists recorded meetings whose recording ended in the range, newest first. **Each meeting includes** - Its title and meeting platform - When recording started and ended, and the hours recorded - The members who added the notetaker - The members who joined, and how many other people joined Filter by a person to list the meetings they joined. Page through results with `cursor`. Requires the Meetings permission (`meetings:read`). ## OpenAPI ````yaml /admin-api-openapi.json get /meetings openapi: 3.1.1 info: title: Cassidy Admin API description: Read your organization's usage analytics and activity in Cassidy. version: 1.0.0 servers: - url: https://app.cassidyai.com/api/admin/v1 security: [] tags: - name: Analytics - name: Workflow runs - name: Chats - name: Meetings - name: Audit logs externalDocs: url: https://docs.cassidyai.com/reference/admin-api paths: /meetings: get: tags: - Meetings summary: List meetings description: >- Lists recorded meetings whose recording ended in the range, newest first. **Each meeting includes** - Its title and meeting platform - When recording started and ended, and the hours recorded - The members who added the notetaker - The members who joined, and how many other people joined Filter by a person to list the meetings they joined. Page through results with `cursor`. Requires the Meetings permission (`meetings:read`). operationId: listMeetings parameters: - in: query name: from schema: type: string format: date-time description: >- Inclusive start of the range, by when recording ended, as an ISO 8601 timestamp. required: true description: >- Inclusive start of the range, by when recording ended, as an ISO 8601 timestamp. - in: query name: to schema: type: string format: date-time description: >- Exclusive end of the range as an ISO 8601 timestamp. The range can span at most 31 days. required: true description: >- Exclusive end of the range as an ISO 8601 timestamp. The range can span at most 31 days. - in: query name: limit schema: description: Maximum number of records to return. default: 100 type: integer minimum: 1 maximum: 1000 description: Maximum number of records to return. - in: query name: cursor schema: description: The `nextCursor` from the previous page. type: string description: The `nextCursor` from the previous page. - in: query name: userId schema: description: Only list meetings this user joined. type: string description: Only list meetings this user joined. responses: '200': description: Successful response content: application/json: schema: type: object properties: nextCursor: description: >- Pass as `cursor` to get the next page. Null on the last page. type: - string - 'null' meetings: type: array items: type: object properties: id: type: string title: type: string platform: type: string enum: - googleMeet - zoom - microsoftTeams - webex recordingStartedAt: type: string recordingEndedAt: type: string hours: type: number description: >- Hours recorded, from when the notetaker started recording until it stopped. The meeting counts this toward `meetingHours` once. owners: type: array items: type: object properties: id: type: string name: type: string email: type: - string - 'null' required: - id - name - email description: Members who added the notetaker to the meeting. participants: type: array items: type: object properties: id: type: string name: type: string email: type: - string - 'null' required: - id - name - email description: >- Members who joined the meeting, matched to participants by email. externalParticipantCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Participants who aren't matched to a member, such as guests. Members who joined without an email the meeting platform shares count here too. required: - id - title - platform - recordingStartedAt - recordingEndedAt - hours - owners - participants - externalParticipantCount required: - nextCursor - meetings '400': description: Invalid input data content: application/json: schema: $ref: '#/components/schemas/error.BAD_REQUEST' '401': description: Authorization not provided content: application/json: schema: $ref: '#/components/schemas/error.UNAUTHORIZED' '403': description: Insufficient access content: application/json: schema: $ref: '#/components/schemas/error.FORBIDDEN' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/error.NOT_FOUND' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR' security: - bearerAuth: - meetings:read components: schemas: error.BAD_REQUEST: type: object properties: message: type: string description: The error message example: Invalid input data code: type: string description: The error code example: BAD_REQUEST issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message required: - message - code title: Invalid input data error (400) description: The error information example: code: BAD_REQUEST message: Invalid input data issues: [] error.UNAUTHORIZED: type: object properties: message: type: string description: The error message example: Authorization not provided code: type: string description: The error code example: UNAUTHORIZED issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message required: - message - code title: Authorization not provided error (401) description: The error information example: code: UNAUTHORIZED message: Authorization not provided issues: [] error.FORBIDDEN: type: object properties: message: type: string description: The error message example: Insufficient access code: type: string description: The error code example: FORBIDDEN issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message required: - message - code title: Insufficient access error (403) description: The error information example: code: FORBIDDEN message: Insufficient access issues: [] error.NOT_FOUND: type: object properties: message: type: string description: The error message example: Not found code: type: string description: The error code example: NOT_FOUND issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message required: - message - code title: Not found error (404) description: The error information example: code: NOT_FOUND message: Not found issues: [] error.INTERNAL_SERVER_ERROR: type: object properties: message: type: string description: The error message example: Internal server error code: type: string description: The error code example: INTERNAL_SERVER_ERROR issues: description: An array of issues that were responsible for the error example: [] type: array items: type: object properties: message: type: string required: - message required: - message - code title: Internal server error error (500) description: The error information example: code: INTERNAL_SERVER_ERROR message: Internal server error issues: [] securitySchemes: bearerAuth: type: http scheme: bearer description: An Admin API key, starting with `cas_admin_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.