---
title: "Wartungen auflisten"
description: "Listet die geplanten Wartungen deiner Status-Seiten."
---

`GET /api/status-pages/maintenances`

## Zugriff

Organisations-`admin`, `editor` und `readonly`. Ein kundengebundener Nutzer oder API-Token sieht nur Wartungen, deren Status-Seiten alle zu einem Kunden in seinem Bereich gehören. Eine Wartung einer anderen Organisation antwortet `404` (`statusPageMaintenanceNotFound`). IDs im Pfad nehmen die numerische ID oder die `publicId`.

## Query-Parameter

| Parameter | Typ | Standard | Beschreibung |
|-----------|-----|----------|--------------|
| `statusPageId` | number\|string | - | Nur Wartungen, die auf dieser Status-Seite stehen (ID oder `publicId`). |
| `state` | string | - | Kommagetrennt: `scheduled`, `in_progress`, `completed`, `cancelled`. |
| `page` | number | `1` | |
| `perPage` | number | `50` | Höchstens 200. |

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/status-pages/maintenances?state=scheduled,in_progress" \
  -H "Authorization: Bearer $TOKEN"
```

## Antwort

`200 OK`, neuester Beginn zuerst. Jeder Eintrag hat dieselbe Form wie [Wartung abfragen](/de/api/status-pages/get-status-page-maintenance):

```json
{
  "items": [ { "id": 12, "title": "Database upgrade", "state": "scheduled", "...": "..." } ],
  "total": 1,
  "page": 1,
  "perPage": 50
}
```

## Häufige Fehler

- `400 Bad Request` (`invalidIdentifier`), wenn eine ID weder Zahl noch UUID ist
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden` (`forbidden`), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
- `403 Forbidden` (`statusPagesModuleDisabled`), wenn das Statusseiten-Modul nicht aktiviert ist
- `404 Not Found` (`statusPageNotFound`), wenn eine Status-Seite nicht existiert oder zu einer anderen Organisation gehört
- `400 Bad Request` (`invalidRequestBody`), wenn `state`, `page` oder `perPage` ungültig ist