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

# Get a team's on-call schedule

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

Get the on-call schedule for a team, including on-call overrides.

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

## Path parameters

- `team` 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 team

- 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` — Team not found
- `429` — Rate-limit reached
- `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)