v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB
Cal Unified Calendars

Get free/busy times

Get busy time slots for the authenticated user's selected calendars in the given date range. Currently only Google Calendar is supported.

get/v2/calendars/{calendar}/freebusy

Path parameters

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

Query parameters

fromstring required
Example:2026-03-10

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

tostring required
Example:2026-03-10

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

timeZonestring

IANA time zone (e.g. America/New_York)

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"
}