Skip to main content
GET
/
rooms
List rooms
curl --request GET \
  --url https://api.timeless.day/v1/rooms \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "room_abc123",
      "title": "Engineering standups",
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-15T10:30:00Z",
      "meeting_count": 42,
      "meetings": [
        {
          "id": "mtg_abc123",
          "title": "Weekly standup",
          "status": "completed",
          "source": "google_meet",
          "start_time": "2025-01-15T10:00:00Z",
          "duration": 1800
        }
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Query Parameters

id
string[] | null

Filter by one or more room IDs.

scope
enum<string>
default:all

Filter by ownership scope.

  • all — all accessible rooms
  • owned — rooms you own
  • shared — rooms shared with you
Available options:
owned,
shared,
all
search
string | null

Search by room title.

expand
enum<string>[] | null

Expand related resources inline. Supported values: documents, meetings.

Available options:
documents,
meetings
cursor
string | null

Pagination cursor from a previous response's next_cursor.

limit
integer
default:25

Number of results per page (1–100).

Required range: 1 <= x <= 100

Response

A paginated list of rooms.

data
Room · object[]
required
next_cursor
string | null
required

Cursor for the next page. null if no more results.

has_more
boolean
required

Whether more results exist beyond this page.