---
title: "List on-call schedules."
method: GET
path: "/schedules"
tags: ["Schedules"]
---

# List on-call schedules.

`GET /schedules`

## Query parameters

- `include` string[]
- `start-index` integer
- `max-results` integer

## Response `200`

a list of on-call schedules

- Schedule[]
  - `id` integer
  - `name` string
  - `timezone` 'Europe/Berlin' | 'America/New_York' | 'America/Los_Angeles' | 'Asia/Istanbul'
  - `type` 'STATIC' | 'RECURRING'
  - `scheduleLayers` ScheduleLayerConfig[]
    - `name` string
    - `startsOn` string, date-time, required
    - `endsOn` string, date-time
    - `users` UserRel[], required
      - `id` integer, required
      - `firstName` string
      - `lastName` string
    - `rotation` string, P7D, required — ISO-8601 duration of the rotation length. Whole-day rotations are formatted like 'P7D'; hourly (sub-day) rotations are supported and formatted like 'PT4H'.
    - `restrictionType` 'TIMES_OF_WEEK' — Note: 'TIMES_OF_DAY' is just a UI state representation, the API always uses 'TIMES_OF_WEEK'
    - `restrictions` ScheduleLayerRestriction[]
      - `from` TimeOfWeek, required
        - `dayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
        - `time` string, 15:00, required
      - `to` TimeOfWeek, required
        - `dayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
        - `time` string, 15:00, required
  - `shifts` ShiftRel[]
    - `user` UserRel
      - `id` integer, required
      - `firstName` string
      - `lastName` string
    - `end` string, date-time
    - `start` string, date-time
  - `showGaps` boolean
  - `defaultShiftDuration` string, P7D
  - `currentShift` ShiftRel
    - `user` UserRel
      - `id` integer, required
      - `firstName` string
      - `lastName` string
    - `end` string, date-time
    - `start` string, date-time
  - `nextShift` ShiftRel
    - `user` UserRel
      - `id` integer, required
      - `firstName` string
      - `lastName` string
    - `end` string, date-time
    - `start` string, date-time
  - `teams` TeamRel[]
    - `id` integer
    - `name` string

---

[API](https://skmtc.dev/ilert/apis/ilert-rest-api.md) · [All operations](https://skmtc.dev/ilert/apis/ilert-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ilert/ilert-rest-api/revisions/cb7d5a5f9ab8/schema)