TItimeless
meetings

List meetings

Changed on

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

get/meetings

Request

  • Base URL
    https://api.timeless.day/v1
  • URL
    https://api.timeless.day/v1/meetings
  • Auth
    HTTP bearer

Query parameters

idstring[] nullable

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

scope'owned' | 'shared' | 'all'

Filter by ownership scope.

  • all — all accessible meetings
  • owned — meetings you hosted
  • shared — meetings shared with you, directly or through a room shared with you
status'completed' | 'processing' | 'scheduled' | 'failed'

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

start_datestring date nullable

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

end_datestring date nullable

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

searchstring nullable

Search by meeting title (substring match).

qstring nullable

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

participantstring nullable

Filter by participant name or email.

companystring nullable

Filter by company name or domain.

room_idstring nullable

Filter by room ID (e.g., room_abc123). Returns the room's meetings that you can access.

expandMeetingExpand[] nullable

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

cursorstring nullable

Pagination cursor from a previous response's next_cursor.

limitinteger

Number of results per page (1–100).

Response

A paginated list of meetings.

next_cursorstring nullable required

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

has_moreboolean required

Whether more results exist beyond this page.

Example response

{
  "data": [
    {
      "id": "mtg_abc123",
      "title": "Weekly standup",
      "start_time": "2025-01-15T10:00:00Z",
      "end_time": "2025-01-15T10:30:00Z",
      "duration": 1800,
      "share_url": "https://my.timeless.day/m/N0tkM21RcFgydkxuUjhzWWZUNGJaYTlXbTV0SGNKNnlRbkIzeFZwTDdkR2s=",
      "host": {
        "id": "usr_def456",
        "name": "Alice Johnson",
        "email": "alice@example.com"
      },
      "participants": [
        {
          "name": "Bob Smith",
          "email": "bob@example.com",
          "title": "Engineer",
          "company": "Acme Corp"
        }
      ],
      "documents": [
        {
          "id": "doc_abc123",
          "title": "Meeting summary",
          "created_at": "2025-01-15T10:35:00Z"
        }
      ],
      "shared_with": [
        {
          "user": {
            "id": "usr_def456",
            "name": "Alice Johnson",
            "email": "alice@example.com"
          }
        }
      ],
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

Changes

  • 10a43448b654Revision changes
    • info

      added the enum value shared_with to the property anyOf[subschema #1]/items/ of the query request parameter expand

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status