v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB
Cal Unified Calendars

Get free/busy for a connection

Get busy time slots for the specified calendar connection.

get/v2/calendars/connections/{connectionId}/freebusy

Path parameters

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