> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.spott.io/llms.txt > Use this file to discover all available pages before exploring further. # List meetings > Returns a list of meetings. Uses cursor pagination. ## OpenAPI ````yaml /openapi-private.json get /meetings openapi: 3.1.0 info: title: Spott API Reference version: '0.1' servers: - url: https://api.gospott.com security: [] tags: [] paths: /meetings: get: tags: - Meetings summary: List meetings description: Returns a list of meetings. Uses cursor pagination. operationId: getMeetings parameters: - name: limit required: false in: query description: >- Number of meetings to return per page (min: 1, max: 50, default: 25). schema: minimum: 1 maximum: 50 default: 25 example: 25 type: integer - name: cursor required: false in: query description: >- Base64-encoded cursor for pagination. Use the cursor value from a previous response to fetch the next page. Omit for the first page. schema: example: >- eyJtb2RpZmllZEF0IjoiMjAyNC0xMS0wNlQxMDozMDowMC4wMDBaIiwiaWQiOiJtZWV0aW5nLTEyMyJ9 type: string - name: modifiedSince required: false in: query description: >- Filter meetings by sync watermark on or after this date. The watermark is updated when the meeting, its links, or its transcripts change. schema: $ref: '#/components/schemas/DateISO' default: '1970-01-01T00:00:00.000Z' example: '2024-11-01T00:00:00.000Z' - name: modifiedUntil required: false in: query description: >- Filter meetings by sync watermark on or before this date. Useful for bounded synchronization snapshots. If omitted, no upper bound is applied. schema: $ref: '#/components/schemas/DateISO' example: '2024-11-30T23:59:59.999Z' - name: startsAfter required: false in: query description: >- Only include meetings whose start time is on or after this date/time (inclusive). schema: $ref: '#/components/schemas/DateISO' example: '2024-06-01T00:00:00.000Z' - name: startsBefore required: false in: query description: >- Only include meetings whose start time is on or before this date/time (inclusive). schema: $ref: '#/components/schemas/DateISO' example: '2024-06-30T23:59:59.999Z' responses: '200': description: >- Successfully retrieved meetings. Returns items with pagination info containing the cursor for the next page. content: application/json: schema: $ref: '#/components/schemas/GetMeetingsResponseDto' '400': description: >- Bad request - invalid query parameters (e.g., limit out of range, invalid date format) content: application/json: schema: allOf: - $ref: '#/components/schemas/ExceptionBaseDto' - type: object properties: statusCode: type: number example: 400 message: type: string example: Limit must be between 1 and 50 error: type: string example: Bad Request '401': description: Unauthorized - invalid or missing authentication content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' '500': description: Error response content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' security: - x-api-key: [] components: schemas: DateISO: id: DateISO format: date-time anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ GetMeetingsResponseDto: type: object properties: items: type: array items: $ref: '#/components/schemas/MeetingListItemDto' pagination: $ref: '#/components/schemas/MeetingCursorPaginationDto' required: - items - pagination id: PrivateGetMeetingsResponseDto ExceptionBaseDto: type: object properties: status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 message: type: string requestId: type: string required: - status - message - requestId id: ExceptionBaseDto MeetingListItemDto: type: object properties: id: type: string title: type: string provider: $ref: '#/components/schemas/MeetingProvider' startTime: $ref: '#/components/schemas/DateISO' endTime: $ref: '#/components/schemas/DateISO' onlineJoinUrl: anyOf: - type: string - type: 'null' participants: type: array items: $ref: '#/components/schemas/MeetingListParticipantDto' transcripts: type: array items: $ref: '#/components/schemas/IdDto' required: - id - title - provider - startTime - endTime - onlineJoinUrl - participants - transcripts id: PrivateMeetingListItemDto MeetingCursorPaginationDto: type: object properties: cursor: anyOf: - type: object properties: modifiedAt: $ref: '#/components/schemas/DateISO' id: type: string required: - modifiedAt - id - type: 'null' type: - string - 'null' hasMore: type: boolean deprecated: true description: >- Use the cursor presence to identify if there are more results to fetch instead. This property will be removed in a future release required: - cursor - hasMore id: PrivateMeetingCursorPaginationDto MeetingProvider: id: PrivateMeetingProvider type: - string - 'null' enum: - googleMeet - zoom - microsoftTeams - audioFile - null MeetingListParticipantDto: type: object properties: name: anyOf: - type: string - type: 'null' email: type: string required: - name - email id: PrivateMeetingListParticipantDto IdDto: type: object properties: id: type: string minLength: 1 required: - id id: IdDto securitySchemes: x-api-key: type: apiKey name: x-api-key in: header description: >- API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard. ````