Cal Unified Calendars

Get free/busy for a connection

Changed on

Get busy time slots for the specified calendar connection.

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

Request

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

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

Changes