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

# List upcoming meetings

> Return visible native meetings and connected calendar events that have not ended.

Return visible native meetings and connected calendar events that have not ended.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `meetings:read`.

Schedule items are deduplicated where a native meeting and calendar event represent the same event, then sorted by start time. In-progress events can appear. Privacy levels are full, title\_time, or busy; respect redacted fields.

## Parameters

<ParamField query="limit" type="integer">
  Default 30; 1–100.
</ParamField>

## Response

**200** — `data` contains [schedule items](/api-reference/raycast/models#schedule-items). Example status and IDs are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "meeting_example",
        "source": "meeting",
        "title": "Kickoff",
        "startTime": "2026-09-08T10:00:00.000Z",
        "endTime": "2026-09-08T10:30:00.000Z",
        "isAllDay": false,
        "status": "scheduled",
        "detailLevel": "full",
        "location": null,
        "description": null,
        "joinUrl": null,
        "webUrl": "https://app.getkato.io/northlane/calendar?meetingId=meeting_example",
        "linkedMeetingId": "meeting_example"
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    "https://api.getkato.io/v1/raycast/meetings/upcoming" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
    --data-urlencode "limit=30"
  ```
</RequestExample>


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Get task creation options](/api-reference/raycast/task-options.md)
- [Get the daily brief](/api-reference/raycast/brief.md)
- [Raycast](/integrations/raycast.md)
- [Raycast response models](/api-reference/raycast/models.md)