---
title: "Get a schedule"
method: GET
path: "/v2/schedules/{scheduleId}"
tags: ["Schedules"]
---

# Get a schedule

`GET /v2/schedules/{scheduleId}`

<Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.</Note>

## Path parameters

- `scheduleId` number, required

## Headers

- `Authorization` string, required
- `cal-api-version` string, required

## Response `200`

- GetScheduleOutput20240611
  - `status` 'success' | 'error', required
  - `data` ScheduleOutput20240611, required
    - `id` number, required
    - `ownerId` number, required
    - `name` string, required
    - `timeZone` string, required
    - `availability` ScheduleAvailabilityInput20240611[], required
      - `days` string[], required — Array of days when schedule is active.
      - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 08:00
      - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 15:00
    - `isDefault` boolean, required
    - `overrides` ScheduleOverrideInput20240611[], required
      - `date` string, required
      - `startTime` string, required — startTime must be a valid time in format HH:MM e.g. 12:00
      - `endTime` string, required — endTime must be a valid time in format HH:MM e.g. 13:00
  - `error` object

## Changes

- **2026-07-17** (v2) `16de9d3eb7b3` — 11 info
  - removed the `Friday` enum value from the `data/allOf[#/components/schemas/ScheduleOutput_2024_06_11]/availability/items/days` response property for the response status `200`
  - removed the `Monday` enum value from the `data/allOf[#/components/schemas/ScheduleOutput_2024_06_11]/availability/items/days` response property for the response status `200`
  - removed the `Saturday` enum value from the `data/allOf[#/components/schemas/ScheduleOutput_2024_06_11]/availability/items/days` response property for the response status `200`
  - removed the `Sunday` enum value from the `data/allOf[#/components/schemas/ScheduleOutput_2024_06_11]/availability/items/days` response property for the response status `200`
  - …7 more
- …earlier changes not shown

[Full history](https://skmtc.dev/calcom/apis/cal-diy-api-v2/changes/v2/schedules/:scheduleId/get.md)

---

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