---
title: "Get team maintenance"
method: GET
path: "/api/{cloudId}/v1/teams/{teamId}/maintenances/{id}"
tags: ["Maintenances"]
---

# Get team maintenance

`GET /api/{cloudId}/v1/teams/{teamId}/maintenances/{id}`

This request is used to retrieve a specific maintenance of a specific team.

## Path parameters

- `teamId` string, required
- `id` string, required

## Response `200`

Returned if the request is successful.

- GetTeamMaintenance
  - `teamId` string — Identifier of the maintenance owning team.
  - `id` string — Identifier of the maintenance.
  - `status` 'cancelled' | 'past' | 'active' | 'planned' — Current status of the maintenance plan.
  - `description` string — Description or name for the maintenance plan. This can be any text that helps identify the purpose or characteristics of the maintenance plan.
  - `startDate` string, date-time — Date and time when the maintenance plan starts.
  - `endDate` string, date-time — Date and time when the maintenance plan ends.
  - `rules` object[] — Rules of maintenance, which takes a list of rule objects and defines the maintenance rules over policies, integrations and syncs.
    - `entity` MaintenanceEntity — Entities within a maintenance policy rule are used to specify which entity like policy, integration or sync should enabled or disabled during maintenance period.
      - `id` string
      - `type` 'sync' | 'integration' | 'policy'
    - `state` 'disabled' | 'enabled' — State of rule that will be defined in maintenance. This field has to be disabled for integrations and syncs.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the request user does not have read-only permission for maintenance plans.
- `404` — Returned if the maintenance owning team or maintenance is not found.
- `422` — Returned if the payload cannot be validated.

---

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