---
title: "List global maintenances"
method: GET
path: "/api/{cloudId}/v1/maintenances"
tags: ["Maintenances"]
---

# List global maintenances

`GET /api/{cloudId}/v1/maintenances`

This endpoint is used to retrieve a list of maintenance that have been created within your organization's account in the Jira Service Management system. It optionally takes three parameters - offset, size and type.

## Query parameters

- `type` 'all' | 'non-expired' | 'past'
- `offset` integer
- `size` integer

## Response `200`

Returned if the request is successful.

- object
  - `values` GetGlobalMaintenance[]
    - `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.
  - `links` MaintenanceLinks
    - `next` string, nullable — Link to the next page of results.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `422` — Returned if the payload or request 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)