---
title: "Get busy times"
method: GET
path: "/v2/calendars/busy-times"
tags: ["Calendars"]
---

# Get busy times

`GET /v2/calendars/busy-times`

Get busy times from a calendar. Example request URL is `https://api.cal.com/v2/calendars/busy-times?timeZone=Europe%2FMadrid&dateFrom=2024-12-18&dateTo=2024-12-18&calendarsToLoad[0][credentialId]=135&calendarsToLoad[0][externalId]=skrauciz%40gmail.com`. Note: loggedInUsersTz is deprecated, use timeZone instead.

## Query parameters

- `loggedInUsersTz` string
- `timeZone` string
- `dateFrom` string
- `dateTo` string
- `credentialId` number, required
- `externalId` string, required

## Headers

- `Authorization` string, required

## Response `200`

- GetBusyTimesOutput
  - `status` 'success' | 'error', required
  - `data` BusyTimesOutput[], required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `source` string, nullable

---

[API](https://skmtc.net/calcom/apis/cal-diy-api-v2.md) · [All operations](https://skmtc.net/calcom/apis/cal-diy-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/calcom/cal-diy-api-v2/versions/16de9d3eb7b3/schema)