---
title: "List meetings"
method: GET
path: "/meetings"
tags: ["meetings"]
---

# List meetings

`GET /meetings`

Returns a paginated list of meetings accessible to the authenticated user. Supports filtering by status, date range, participants, company, room, and more.

## Query parameters

- `id` string[], nullable
- `scope` 'owned' | 'shared' | 'all'
- `status` 'completed' | 'processing' | 'scheduled' | 'failed'
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `search` string, nullable
- `q` string, nullable
- `participant` string, nullable
- `company` string, nullable
- `room_id` string, nullable
- `expand` MeetingExpand[], nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

A paginated list of meetings.

- PaginatedResponseMeeting
  - `data` Meeting[], required
    - `id` string, required — Meeting ID.
    - `title` string, required — Meeting title.
    - `status` 'completed' | 'processing' | 'scheduled' | 'failed', required
    - `source` 'google_meet' | 'zoom' | 'teams' | 'slack' | 'whatsapp' | 'phone' | 'upload' | 'desktop'
    - `start_time` string, date-time, required — ISO 8601 timestamp.
    - `end_time` string, date-time, nullable — ISO 8601 timestamp.
    - `duration` integer, nullable — Duration in seconds.
    - `host` UserSchema
      - `id` string, required — User ID.
      - `name` string, required — Display name.
      - `email` string, required — Email address.
    - `participants` Participant[], required — Meeting participants.
      - `name` string, nullable, required — Participant name.
      - `email` string, required — Email address.
      - `title` string, nullable, required — Job title.
      - `company` string, nullable, required — Company name.
    - `documents` Document[] — Only present when `expand=documents` is requested.
      - `id` string, required
      - `title` string, required
      - `created_at` string, date-time, required
    - `created_at` string, date-time, required — ISO 8601 timestamp.
  - `next_cursor` string, nullable, required — Cursor for the next page. `null` if no more results.
  - `has_more` boolean, required — Whether more results exist beyond this page.

## Other responses

- `401` — Authentication required.
- `422` — Validation Error

---

[API](https://skmtc.net/timeless/apis/timeless-public-api.md) · [All operations](https://skmtc.net/timeless/apis/timeless-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timeless/timeless-public-api/versions/e591036e462c/schema)