---
title: "Read a fresh calendar event and provider revision"
method: GET
path: "/v1/integrations/{id}/events/{eventId}"
---

# Read a fresh calendar event and provider revision

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

## Request

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

Required calendarId query. Fresh event with sourceRevision and fetchedAt. URL-encode IDs in both paths and query values. For Apple, pass the opaque externalId returned by the event list unchanged as eventId. It addresses the CalDAV resource, not its iCalendar UID; do not construct or decode it.

## Path parameters

- `id` string, required
- `eventId` string, required

## Query parameters

- `calendarId` string, required

## Response `200`

Current event

- object
  - `event` 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
    - `provider` 'google-calendar' | 'apple-calendar', required
    - `sourceUrl` string, required
    - `fetchedAt` string, required
    - `etag` 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).
- `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)