> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # List meeting recordings > Retrieve a paginated list of meeting recordings with optional filters. **Filters**: `processing_status`, `calendar_meeting_id`, `meeting_started_after`, `meeting_started_before` (ISO 8601 date range). **Sorting**: `sort_by` (meeting_started_at, created_at, recording_duration_seconds) with `sort_order` (asc/desc, default desc). **Pagination**: Use `offset` and `limit` query params (max 100 per page). ## OpenAPI ````yaml /api-reference/openapi-v1.json get /v1/meeting-recordings openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/meeting-recordings: get: tags: - Meeting Recordings summary: List meeting recordings description: >- Retrieve a paginated list of meeting recordings with optional filters. **Filters**: `processing_status`, `calendar_meeting_id`, `meeting_started_after`, `meeting_started_before` (ISO 8601 date range). **Sorting**: `sort_by` (meeting_started_at, created_at, recording_duration_seconds) with `sort_order` (asc/desc, default desc). **Pagination**: Use `offset` and `limit` query params (max 100 per page). operationId: listMeetingRecordings parameters: - schema: type: - integer - 'null' minimum: 0 default: 0 description: Records to skip for pagination. Defaults to 0. required: false name: offset in: query - schema: type: integer minimum: 1 maximum: 100 default: 100 description: Max records per page (1–100). Defaults to 100. required: false name: limit in: query - schema: type: string enum: - pending - processing - completed - failed description: >- Filter by processing status. Use `completed` to find recordings with transcripts ready. required: false name: processing_status in: query - schema: type: string format: uuid description: Filter recordings belonging to a specific calendar meeting. required: false name: calendar_meeting_id in: query - schema: type: string description: >- Return recordings where the meeting started at or after this timestamp (ISO 8601). Example: `2026-04-01T00:00:00Z`. required: false name: meeting_started_after in: query - schema: type: string description: >- Return recordings where the meeting started at or before this timestamp (ISO 8601). Example: `2026-04-30T23:59:59Z`. required: false name: meeting_started_before in: query - schema: type: string enum: - meeting_started_at - created_at - recording_duration_seconds default: created_at description: |- Column to sort results by. Defaults to `created_at`. - `meeting_started_at` — when the meeting occurred - `created_at` — when the recording was created in the system - `recording_duration_seconds` — recording length required: false name: sort_by in: query - schema: type: string enum: - asc - desc default: desc description: Sort direction. Defaults to `desc` (newest first). required: false name: sort_order in: query responses: '200': description: Meeting recordings fetched content: application/json: schema: $ref: '#/components/schemas/MeetingRecordingsListResponse' example: success: true data: - id: 5c6d7e8f-9012-3456-7890-abcdef012345 calendar_meeting_id: 6d7e8f90-1234-5678-9012-abcdef012345 calendar_meeting: id: 6d7e8f90-1234-5678-9012-abcdef012345 meeting_title: Weekly Engineering Sync meeting_url: https://meet.google.com/abc-defg-hij start_time: '2026-04-07T10:00:00.000Z' meeting_started_at: '2026-04-07T10:00:00.000Z' meeting_ended_at: '2026-04-07T11:00:00.000Z' recording_duration_seconds: 3600 processing_status: completed has_transcript: true created_at: '2026-04-07T11:05:00.000Z' updated_at: '2026-04-07T11:10:00.000Z' meta: total: 15 offset: 0 limit: 20 '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: MeetingRecordingsListResponse: type: object properties: success: type: boolean enum: - true data: type: array items: $ref: '#/components/schemas/MeetingRecordingListItem' meta: type: object properties: total: type: number description: Total matching records across all pages. offset: type: number description: Current pagination offset. limit: type: number description: Page size used for this request. required: - total - offset - limit required: - success - data - meta MeetingRecordingListItem: type: object properties: id: type: string description: Meeting recording UUID. calendar_meeting_id: type: - string - 'null' description: Associated calendar meeting UUID. calendar_meeting: type: - object - 'null' properties: id: type: string description: Calendar meeting UUID. meeting_title: type: - string - 'null' description: Meeting title. meeting_url: type: string description: Meeting URL (e.g. Zoom/Google Meet link). start_time: type: string description: Meeting start time (ISO 8601). required: - id - meeting_title - meeting_url - start_time description: Calendar meeting details. meeting_started_at: type: - string - 'null' description: When the meeting started (ISO 8601). meeting_ended_at: type: - string - 'null' description: When the meeting ended (ISO 8601). recording_duration_seconds: type: - number - 'null' description: Duration of the recording in seconds. processing_status: type: - string - 'null' description: 'Processing status: pending, processing, completed, or failed.' has_transcript: type: boolean description: >- Whether a transcript is available. Use GET /v1/meeting-recordings/{id} to fetch the full transcript. created_at: type: string description: ISO 8601 creation timestamp. updated_at: type: string description: ISO 8601 last update timestamp. required: - id - calendar_meeting_id - calendar_meeting - meeting_started_at - meeting_ended_at - recording_duration_seconds - processing_status - has_transcript - created_at - updated_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````