Skip to main content
GET
List meetings

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Query Parameters

id
string[] | null

Filter by one or more meeting IDs. Pass multiple values to fetch specific meetings: ?id=mtg_abc&id=mtg_def

scope
enum<string>
default:all

Filter by ownership scope.

  • all — all accessible meetings
  • owned — meetings you hosted
  • shared — meetings shared with you
Available options:
owned,
shared,
all
status
enum<string> | null

Filter by meeting status: completed, processing, scheduled, or failed.

Available options:
completed,
processing,
scheduled,
failed
start_date
string<date> | null

Filter meetings starting on or after this date. Format: YYYY-MM-DD.

end_date
string<date> | null

Filter meetings starting on or before this date. Format: YYYY-MM-DD.

search
string | null

Search by meeting title (substring match).

q
string | null

Semantic search query. Finds meetings whose content is relevant to the query, not just title matches.

participant
string | null

Filter by participant name or email.

company
string | null

Filter by company name or domain.

room_id
string | null

Filter by room ID (e.g., room_abc123).

expand
enum<string>[] | null

Expand related resources inline. Supported values: documents.

Available options:
documents
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 meetings.

data
Meeting · 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.