---
title: "Get Schedule"
method: GET
path: "/api/v1/scheduling/schedules/{id}"
tags: ["Scheduling", "Public API"]
---

# Get Schedule

`GET /api/v1/scheduling/schedules/{id}`

Retrieves a specific schedule by its UUID. Schedules organize shifts for employees.

OAuth Scopes: scheduling:schedules, time_tracking

## Path parameters

- `id` string, uuid, required

## Response `200`

Schedule retrieved successfully

- SchedulingScheduleV1 — A shift schedule for a specific location, which organizes shifts for employees
  - `id` string, uuid — The UUID of the schedule
  - `name` string — The name of the schedule
  - `locationId` integer — The ID of the location the schedule belongs to
  - `timezone` string — The timezone of the schedule, provide if location is missing timezone
  - `startOfWeek` string — The starting day of the week for the schedule
  - `earlyClockInThreshold` integer — The threshold (in minutes) that an employee is allowed to clock in early to a shift on this schedule
  - `lateClockInThreshold` integer — The threshold (in minutes) after a shift starts before an employee is considered late clocking in
  - `earlyClockOutThreshold` integer — The threshold (in minutes) before a shift ends within which an employee is considered to have clocked out early
  - `lateClockOutThreshold` integer — The threshold (in minutes) after a shift ends before an employee is considered to have clocked out late
  - `managerUserIds` integer[] — What users manage this schedule
  - `employeeIds` integer[] — What employees are assigned to this schedule
  - `createdAt` string, date-time — UTC timestamp when the schedule was created
  - `updatedAt` string, date-time, nullable — UTC timestamp when the schedule was last updated
  - `deletedAt` string, date-time, nullable — UTC timestamp when the schedule was deleted

## Other responses

- `403` — Forbidden - insufficient permissions
- `404` — Schedule not found.
- `422` — Unprocessable entity - invalid UUID format.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/versions/19ebf391a399/schema)