Get free/busy times | iCalendly Docs

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

calendarRequiredstring

Value in: "google" | "office365" | "apple"

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/google/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"
    }
  ]
}

GETGet free/busy times

Path Parameters

Query Parameters

Header Parameters

Response