---
title: "List On Call Lists"
method: GET
path: "/notifications/on-call/rotations"
tags: ["notification-on-call"]
---

# List On Call Lists

`GET /notifications/on-call/rotations`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/notifications/on-call/rotations`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Query parameters

- `handoffs` integer

## Headers

- `organization-id` string, nullable
- `x-user-id` string, nullable
- `timezone` string
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Response `200`

Successful Response

- OnCallListView[]
  - `id` string, nullable, required
  - `name` string, required
  - `timezone` string, required
  - `turn_length_days` integer, required
  - `first_handoff_local` string, date-time, required
  - `members` OnCallListMember[], required
    - `user_id` string, required
    - `name` string, required
    - `position` integer, required
    - `channels` string[]
    - `reasons` string[]
  - `on_call_now` OnCallNow, required: Whoever is on call now, and until when: the next handoff, or the end of the swap that put them on.
    - `user_id` string, required
    - `name` string, required
    - `swap_id` string, nullable
    - `until` string, date-time, nullable
  - `backup` OnCallPerson, required
    - `user_id` string, required
    - `name` string, required
  - `next_handoffs` OnCallHandoff[], required
    - `user_id` string, required
    - `name` string, required
    - `at` string, date-time, required
    - `at_local` string, date-time, required
  - `swaps` OnCallSwap[], required
    - `user_id` string, required
    - `name` string, required
    - `id` string, nullable, required
    - `starts_at` string, date-time, required
    - `ends_at` string, date-time, required
    - `starts_at_local` string, date-time, required
    - `ends_at_local` string, date-time, required
    - `note` string, nullable
  - `warnings` string[], required
  - `rule_keys` string[], required
  - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/upsmith/apis/upsmith-api.md) - [All operations](https://skmtc.dev/upsmith/apis/upsmith-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upsmith/apis/upsmith-api/revisions/86e2c2bd93af?raw)