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

# Get a user's on-call schedule

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

Get the on-call schedule for a user for all teams the user is on, 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

- UserSchedule
  - `teamSchedules` TeamSchedule[]
    - `team` Team
      - `name` string, required — The team name
      - `slug` string, required — The unique identifier for this team. The slug is in the format `team-[\w\d]{16}`
    - `schedules` PolicySchedule[]
      - `policy` EscalationPolicySummary — A summary containing minimal, high-level information about an escalation policy.
        - `name` string, required — The name of this escalation policy
        - `slug` string, required — A unique identifier for this escalation policy. The slug is in the format `pol-[\w\d]{16}`
        - `_selfUrl` string, required — This is a URI that is generated for this escalation policy. It points to the entire escalation policy resource. and can be used to get detailed information about this escalation policy instead of just the summary.
      - `schedule` OnCallEntry[]
        - `onCallUser` User
          - `username` string
        - `overrideOnCallUser` User
          - `username` string
        - `onCallType` 'user' | 'rotation_group' | 'rotation_group_next' | 'rotation_group_previous' | 'team' | 'team_routing' | 'webhook' | 'email' | 'policy_routing', required
        - `rotationName` string
        - `shiftName` string
        - `shiftRoll` string — The shift roll time (ISO 8601)
        - `rolls` OnCallRoll[], required
          - `start` string, required — The on-call period start time (ISO 8601)
          - `end` string, required — The on-call period end time (ISO 8601)
          - `onCallUser` User
            - `username` string
          - `isRoll` boolean, required
      - `overrides` OnCallOverride[]
        - `origOnCallUser` User
          - `username` string
        - `overrideOnCallUser` User
          - `username` string
        - `start` string — The override start time (ISO 8601)
        - `end` string — The override end time (ISO 8601)

## 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)