---
title: "List duty handovers"
method: GET
path: "/api/v1/schedules/{schedule}/overrides"
tags: ["On-call schedules"]
---

# List duty handovers

`GET /api/v1/schedules/{schedule}/overrides`

## Request

- Base URL: `https://wardenpoint.com` (the document declares no server; this is the origin it was published from)
- URL: `https://wardenpoint.com/api/v1/schedules/{schedule}/overrides`
- Auth: API key in header `X-API-Key`

Handovers that are running or still ahead, earliest first. Elapsed ones are omitted: they can no longer be changed and only add noise to the question "what is currently not what the rotation says". Requires the duty-handover feature to be switched on for the deployment — creating a handover does not, mirroring the dashboard exactly.

## Path parameters

- `schedule` string, uuid, required

## Response `200`

The handovers.

- object
  - `data` ScheduleOverride[]
    - `uuid` string, uuid
    - `role` 'primary' | 'secondary' | 'manager'
    - `recipient` object, nullable: Who stands in.
      - `uuid` string, uuid
      - `name` string
    - `replacing` object, nullable: Who they cover for, captured when the handover was created. Null when no shift covered the start moment — a handover over an empty rotation is still valid.
      - `uuid` string, uuid
      - `name` string
    - `starts_at` string, date-time: When the handover begins, rendered in the schedule's own timezone rather than UTC — the same wall clock the schedule page shows.
    - `ends_at` string, date-time: When it ends, in the schedule's timezone.
    - `reason` string, nullable: Whatever was given when the handover was created. Free text for people; nothing routes on it.
    - `is_active` boolean: True while the window covers this instant — i.e. this person is the one an alert would reach right now.
    - `created_at` string, date-time

## Other responses

- `401`: API key missing, invalid, revoked or expired.
- `403`: API key lacks the config.read ability, or the schedule belongs to another company.
- `404`: No schedule with this UUID, or on-call schedules or duty handovers are switched off for this deployment.

---

[API](https://skmtc.dev/wardenpoint/apis/wardenpoint-api.md) · [All operations](https://skmtc.dev/wardenpoint/apis/wardenpoint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wardenpoint/apis/wardenpoint-api/revisions/259ee445728e?raw)