---
title: "Get a user's on-call schedule"
method: GET
path: "/api-public/v1/user/{user}/oncall/schedule"
tags: ["On-call"]
deprecated: true
---

# Get a user's on-call schedule

`GET /api-public/v1/user/{user}/oncall/schedule`

> **Deprecated.**

__NOTE: This call is deprecated. Please use `GET /api-public/v2/user/{user}/oncall/schedule`.__

Get the on-call schedule for a user for all teams, including on-call overrides.

This API may be called a maximum of 2 times per second.

## Path parameters

- `user` string, required

## Query parameters

- `daysForward` number
- `daysSkip` number
- `step` number

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Response `200`

The on-call schedule for the user

- OnCallAndOverrides[]
  - `team` string
  - `schedule` TeamScheduleResource[]
    - `oncall` string — The user scheduled on call (if any)
    - `overrideoncall` string — The user overriding the scheduled on call user (if any)
    - `policyType` string, required
    - `rotationName` string
    - `shiftName` string
    - `shiftRoll` number
    - `rolls` TeamScheduleRollResource[], required
      - `change` number, required — The time the period is scheduled to start
      - `until` number, required — The time the period is scheduled to end
      - `oncall` string — The user scheduled on call (if any)
      - `isRoll` boolean, required
  - `overrides` TeamScheduleOverlayResource[]
    - `orig` string — The user scheduled on call (if any)
    - `over` string — The user overriding the scheduled on call user (if any)
    - `start` number — The time the override is scheduled to start
    - `end` number — The time the override is scheduled to end

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — User not found
- `500` — Internal Server Error

---

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