---
title: "Get an organization's current maintenance mode state"
method: GET
path: "/api-public/v1/maintenancemode"
tags: ["Maintenance Mode"]
---

# Get an organization's current maintenance mode state

`GET /api-public/v1/maintenancemode`

## Headers

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

## Response `200`

maintenance mode state

- MaintenanceModeState
  - `companyId` string
  - `activeInstances` ActiveMaintenanceMode[]
    - `instanceId` string — external friendly unique id for maintenance mode
    - `startedBy` string — username of the user that started maintenance mode
    - `startedAt` number — millis from epoch marking the start time
    - `targets` MaintenanceModeTarget[]
      - `type` 'RoutingKeys'
      - `names` string[] — Routing keys that maintenance mode state covers. An empty list indicates global maintenance mode
    - `isGlobal` boolean — whether this instance is a global maintenance mode or for specific routing keys

## Other responses

- `403` — Authentication failed or rate-limit reached
- `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)