> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List meetings

> Page through the meetings your token owner is invited to: today, upcoming, past or series occurrences.

Returns the meetings the token owner is invited to, not the ones they could merely read through a
Space. Each call returns one page of up to 50 meetings.

<Info>
  Scope `meetings:read`.
</Info>

## Query parameters

<ParamField query="view" type="string" default="upcoming">
  `today` (the current calendar day in the token owner's time zone), `upcoming`, `past` (newest
  first) or `series` (every occurrence of a series, past and future, in calendar order).
</ParamField>

<ParamField query="cursor" type="string">
  The `nextCursor` of the previous page. Leave it out for the first page.
</ParamField>

## Response

<ResponseField name="data" type="object" required>
  <Expandable title="properties">
    <ResponseField name="items" type="object[]" required>
      Meetings with `id`, `title`, `startsAt`, `durationMinutes`, `status`, `visibility`,
      `location`, `videoUrl`, `space` (`id`, `name`, `icon`, `slug`), `project` (`id`, `name`,
      `icon`) and the token owner's `role`.
    </ResponseField>

    <ResponseField name="nextCursor" type="string | null" required>
      Pass it as `cursor` for the next page; `null` on the last page.
    </ResponseField>

    <ResponseField name="timezone" type="string" required>
      The token owner's time zone.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl -X GET "https://your-collabase.ch/api/v1/meetings?view=upcoming" \
    -H "Authorization: Bearer clb_xYz123ABCD..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "data": {
      "items": [
        {
          "id": "cm2meet0001abcd",
          "title": "Release planning",
          "startsAt": "2026-10-15T08:00:00.000Z",
          "durationMinutes": 45,
          "status": "PLANNED",
          "visibility": "STANDARD",
          "location": "Room Aare",
          "videoUrl": null,
          "space": { "id": "cm1space001", "name": "Product", "icon": "📦", "slug": "product" },
          "project": null,
          "role": "ORGANIZER"
        }
      ],
      "nextCursor": null,
      "timezone": "Europe/Zurich"
    }
  }
  ```

  ```json 422 theme={"dark"}
  {
    "error": { "code": "VALIDATION_ERROR", "message": "Invalid option: expected one of \"today\"|\"upcoming\"|\"past\"|\"series\"" }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.