v1

latestOpenAPI 3.1.02026-07-26102934.7 KB

meetings

List meetings

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

get/meetings

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

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).

expandMeetingExpand[] nullable

Expand related resources inline. Supported values: documents.

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,
      "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"
        }
      ],
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}