---
title: "Get all rotations and some rotation details for a team"
method: GET
path: "/api-public/v2/team/{team}/rotations"
tags: ["Rotations"]
---

# Get all rotations and some rotation details for a team

`GET /api-public/v2/team/{team}/rotations`

Retrieves a list of all rotations that exist under the specified team.
The "mask2" and "mask3" properties are optional.
This API may be called a maximum of 2 times per second.

## Path parameters

- `team` string, required

## Headers

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

## Response `200`

An object containing a list of all rotations that exist under the provided team

- object
  - `rotations` Rotation[]
    - `groupId` integer — The unique identifier of the rotation group
    - `label` string — The name of this rotation group
    - `totalMembersInRotation` integer — The total count of members in a rotation
    - `shifts` ShiftDetails[]
      - `shiftId` integer — The unique identifier of the shift
      - `label` string
      - `duration` number
      - `current` OnCallPeriod
        - `start` string — ISO8601 timestamp
        - `end` string — ISO8601 timestamp
        - `username` string
      - `next` OnCallPeriod
        - `start` string — ISO8601 timestamp
        - `end` string — ISO8601 timestamp
        - `username` string
      - `periods` OnCallPeriod[]
        - `start` string — ISO8601 timestamp
        - `end` string — ISO8601 timestamp
        - `username` string
      - `shiftMembers` ShiftMember[]
        - `slug` string
        - `username` string
      - `shifttype` unknown
      - `start` string — ISO8601 timestamp
      - `timezone` string
      - `mask` RotationMask — A definition of the time range and days of the week that the rotation has on-call periods
        - `day` object
          - `su` boolean
          - `m` boolean
          - `t` boolean
          - `w` boolean
          - `th` boolean
          - `f` boolean
          - `sa` boolean
        - `time` MaskTimeRange[]
          - `start` object
            - `hour` number
            - `minute` number
          - `end` object
            - `hour` number
            - `minute` number
      - `mask2` RotationMask — A definition of the time range and days of the week that the rotation has on-call periods
        - `day` object
          - `su` boolean
          - `m` boolean
          - `t` boolean
          - `w` boolean
          - `th` boolean
          - `f` boolean
          - `sa` boolean
        - `time` MaskTimeRange[]
          - `start` object
            - `hour` number
            - `minute` number
          - `end` object
            - `hour` number
            - `minute` number
      - `mast3` RotationMask — A definition of the time range and days of the week that the rotation has on-call periods
        - `day` object
          - `su` boolean
          - `m` boolean
          - `t` boolean
          - `w` boolean
          - `th` boolean
          - `f` boolean
          - `sa` boolean
        - `time` MaskTimeRange[]
          - `start` object
            - `hour` number
            - `minute` number
          - `end` object
            - `hour` number
            - `minute` number

## 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` — Path not found
- `500` — Internal Server Error

---

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