---
title: "List Google events or Apple events and recurring series, upcoming by default, 50 per page"
method: GET
path: "/v1/integrations/{id}/events"
---

# List Google events or Apple events and recurring series, upcoming by default, 50 per page

`GET /v1/integrations/{id}/events`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/integrations/{id}/events`
- Auth: HTTP bearer

Required calendarId query. Up to 50 Google events or Apple events and recurring series, upcoming by default. Optional search, timeMin, timeMax and pageToken. Time bounds need offsets. Continue with nextPageToken and identical filters, including a fixed timeMin. Apple recurring:true identifies a whole series; its start/end describe the original occurrence, and updates change the series master while preserving individual exceptions. An unknown query parameter is rejected with 400 `validation` here - unlike the rest of v1, extra parameters are not ignored.

## Path parameters

- `id` string, required

## Query parameters

- `calendarId` string, required
- `search` string
- `timeMin` string, date-time
- `timeMax` string, date-time
- `pageToken` string

## Response `200`

Events and optional continuation token

- object
  - `events` object[], required
    - `calendarId` string, required
    - `externalId` string, required: Opaque event ID from the event list. Pass unchanged as eventId; Apple resource IDs are not iCalendar UIDs.
    - `title` string, required
    - `start` string, required
    - `end` string, required
    - `timezone` string
    - `recurring` boolean
    - `status` string, required
    - `sourceRevision` string, required
  - `nextPageToken` string

## Other responses

- `400`: Error codes: calendar_unsupported (request), validation (request), calendar_invalid_calendar (request), calendar_invalid_query (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: calendar_not_found (account).
- `409`: Error codes: calendar_read_only (account), calendar_busy (busy), calendar_refresh_in_progress (busy), calendar_unauthorized (account), calendar_oauth_failed (account), calendar_credentials_unavailable (account), calendar_invalid_credentials (account), calendar_stale_revision (request).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `502`: Error codes: calendar_provider_error (service), calendar_invalid_provider_response (service).
- `503`: Error codes: calendar_not_configured (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)