curl --request GET \
--url https://api.cal.com/v2/calendars/busy-times \
--header 'Authorization: <authorization>'
{
"status": "success",
"data": [
{
"start": "2023-11-07T05:31:56Z",
"end": "2023-11-07T05:31:56Z",
"source": "<string>"
}
]
}
Get busy times from a calendar. Example request URL is https://api.cal.com/v2/calendars/busy-times?loggedInUsersTz=Europe%2FMadrid&dateFrom=2024-12-18&dateTo=2024-12-18&calendarsToLoad[0][credentialId]=135&calendarsToLoad[0][externalId]=skrauciz%40gmail.com
curl --request GET \
--url https://api.cal.com/v2/calendars/busy-times \
--header 'Authorization: <authorization>'
{
"status": "success",
"data": [
{
"start": "2023-11-07T05:31:56Z",
"end": "2023-11-07T05:31:56Z",
"source": "<string>"
}
]
}
value must be Bearer <token>
where <token>
is api key prefixed with cal_ or managed user access token
The timezone of the logged in user represented as a string
The starting date for the busy times query
The ending date for the busy times query
The ID of the user's calendar credential used to access the calendar. Retrieve this from your connected calendar credentials via the /v2/credentials
endpoint.
The external calendar identifier from the calendar provider (e.g., email address for Google Calendar). This is returned when listing connected calendars.
The response is of type object
.
Was this page helpful?