Skip to main content
GET
/
meetings
List meetings
curl --request GET \
  --url https://api.timeless.day/v1/meetings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "mtg_abc123",
      "title": "Weekly standup",
      "status": "completed",
      "source": "google_meet",
      "start_time": "2025-01-15T10:00:00Z",
      "end_time": "2025-01-15T10:30:00Z",
      "duration": 1800,
      "host": {
        "id": "usr_def456",
        "name": "Alice Johnson",
        "email": "alice@example.com"
      },
      "participants": [
        {
          "name": "Bob Smith",
          "email": "bob@example.com",
          "title": "Engineer",
          "company": "Acme Corp"
        }
      ],
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX2F0Ijo...",
  "has_more": true
}

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.