---
title: "Get rotation schedule"
method: GET
path: "/rotationschedules/{id}"
tags: ["Rotation Schedules"]
---

# Get rotation schedule

`GET /rotationschedules/{id}`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/rotationschedules/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` integer, required

## Response `200`

Successfully retrieved rotationSchedule's information

- object
  - `rotationSchedule` object, required
    - `id` integer, required: Global ID of the rotation schedule. `0` is an alias addressing the organization's current default rotation: its saved default when it has one, otherwise the virtual default it gets until it saves one of its own. Responses always carry the canonical id, so a request against `0` can come back with a different `id`.
    - `organizationId` integer, required: ID of the organization that owns this resource
    - `name` string, required
    - `startDate` string, date-time, required: First day of the rotation (ISO 8601 UTC datetime, RFC 3339 date-time format). The pattern in `days` repeats from this date.
    - `days` object[], required: The repeating pattern, one entry per day of the cycle, ordered by `dayIndex`.
      - `dayIndex` integer, required: Position of the day in the rotation, starting at 0 on `startDate`
      - `dayType` 'WORKING' | 'NON_WORKING', required
      - `seconds` integer, required: Seconds worked on that day. Always 0 for a `NON_WORKING` day.
    - `isDefault` boolean, required: Whether this is the organization's default rotation, applied to every user without a rotation of their own.
    - `sourceTemplatePattern` string, nullable: Template pattern used to create this rotation in the UI, if one was selected
    - `assignedUsersCount` integer, required: Number of users on this rotation. For the default rotation, every schedulable user not on a rotation of their own. The users themselves are at `GET /rotationschedules/{id}/assignedusers`.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
    - `archivedAt` string, date-time, nullable: When the rotation schedule was archived, or `null` while it is active

## Other responses

- `400`: Error with query
- `401`: Invalid token
- `404`: Could not find the specified rotationSchedule or the user cannot access it.

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-10-16** `08b21e946629`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/rotationschedules/:id/get.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)