---
title: "Get all rotation groups for a team"
method: GET
path: "/api-public/v1/teams/{team}/rotations"
tags: ["Rotations"]
---

# Get all rotation groups for a team

`GET /api-public/v1/teams/{team}/rotations`

Retrieves a list of all rotation groups that exist under the specified team.

This is the current method for retrieving uniquely identifying slugs of existing rotation groups.

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 rotation groups that exist under the provided team A rotation is one rotation and all of its shifts. This is represented in the UI as a single rotation.

- RotationGroupList
  - `rotationGroups` RotationGroup[], required
    - `teamSlug` string, required — The team associated with this rotation group The team slug is in the format `team-[\w\d]{16}`
    - `slug` string, required — A unique identifier for this rotation group The slug is in the format `rtg-[\w\d]{16}`
    - `label` string, required — The name of this rotation group
    - `groupId` string — The group ID of this rotation group

## 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/revisions/7a7391256058/schema)