Cal Unified Calendars

List calendar events

Changed on

List events in a date range for the authenticated user's calendar. Currently only Google Calendar is supported.

get/v2/calendars/{calendar}/events

Request

  • The document declares no server URL.
  • Auth
    none declared. Required headers: Authorization

Path parameters

calendar'google' | 'office365' | 'apple' required

Query parameters

fromstring required
Example:2026-03-01

Start of the date range (ISO 8601 date or date-time)

tostring required
Example:2026-03-31

End of the date range (ISO 8601 date or date-time)

timeZonestring

IANA time zone for the request (e.g. America/New_York)

calendarIdstring

Calendar ID. Use 'primary' for the user's primary calendar, or the external ID of a connected calendar.

Headers

Authorizationstring required

value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token

Response

status'success' | 'error' required

Example response

{
  "status": "success"
}

Changes