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

# List rooms

`GET /rooms`

Returns a paginated list of rooms accessible to the authenticated user. Rooms group related meetings together.

## Query parameters

- `id` string[], nullable
- `scope` 'owned' | 'shared' | 'all'
- `search` string, nullable
- `expand` RoomExpand[], nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

A paginated list of rooms.

- PaginatedResponseRoom
  - `data` Room[], required
    - `id` string, required — Room ID.
    - `title` string, required — Room title.
    - `created_at` string, date-time, required — ISO 8601 timestamp.
    - `updated_at` string, date-time, required — ISO 8601 timestamp.
    - `meeting_count` integer, required — Number of meetings in this room.
    - `documents` Document[] — Only present when `expand=documents` is requested.
      - `id` string, required
      - `title` string, required
      - `created_at` string, date-time, required
    - `meetings` MeetingPreview[] — Only present when `expand=meetings` is requested.
      - `id` string, required
      - `title` string, required
      - `status` 'completed' | 'processing' | 'scheduled' | 'failed', required
      - `source` 'google_meet' | 'zoom' | 'teams' | 'slack' | 'whatsapp' | 'phone' | 'upload' | 'desktop', required
      - `start_time` string, date-time, required
      - `duration` integer, nullable, required
  - `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/revisions/e591036e462c/schema)