iCalendlyDeveloper Docs
Cal unified calendars

GETGet free/busy for a connection

Get busy time slots for the specified calendar connection.

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

Path Parameters

connectionIdRequiredstring

Query Parameters

fromRequiredstring

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

toRequiredstring

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

timeZonestring

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

Header Parameters

AuthorizationRequiredstring

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

curl -X GET "https://example.com/v2/calendars/connections/<string>/freebusy?from=2026-03-10&to=2026-03-10&timeZone=%3Cstring%3E" \
  -H "Authorization: <string>"

{
  "status": "success",
  "data": [
    {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z",
      "source": "string"
    }
  ]
}

Previous

Get event for a connection

Next

Get free/busy times