---
title: "Wartungsfenster auflisten"
description: "Gibt Wartungsfenster zurück, standardmäßig auf deine Organisation scoped."
---

`GET /api/maintenance-windows`

Du kannst nach einem konkreten Ziel (z. B. `websiteId`) oder nach `customerId`/`organizationId` filtern.

## Authentifizierung

Erfordert eine gültige Session.

- Header: `Authorization: Bearer <token>`

## Query Parameter

- `websiteId` (optional)
- `customerId` (optional)
- `organizationId` (optional, Standard: deine Session-Organisation)
- `activeOnly` (optional): `true` liefert nur aktive Fenster
- Target-Filter (optional): `icmpMonitorId`, `smtpMonitorId`, `sshMonitorId`, `ftpMonitorId`, `imapPopMonitorId`

Hinweis (API-Token Scope): Wenn du ein Customer-scoped API-Token nutzt, sind Ergebnisse auf diesen Kunden beschränkt. Ein anderer `customerId` liefert `403`.

## Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/maintenance-windows?websiteId=101" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort (Response)

```json
[
  {
    "id": 5,
    "websiteId": 101,
 "icmpMonitorId": null,
 "smtpMonitorId": null,
 "sshMonitorId": null,
 "ftpMonitorId": null,
 "imapPopMonitorId": null,
    "customerId": 12,
   "customerName": "Acme Corp",
    "name": "Wöchentliche Wartung",
    "description": "Geplante Downtime",
    "startTime": "2026-02-25T02:00:00.000Z",
    "endTime": "2026-02-25T04:00:00.000Z",
    "isRecurring": true,
    "recurrencePattern": {
      "frequency": "weekly",
      "interval": 1,
      "daysOfWeek": [1]
    },
    "isActive": true,
 "timezone": "UTC",
 "createdBy": "<user-id>",
 "createdAt": "2026-02-20T10:00:00.000Z",
 "updatedAt": "2026-02-20T10:00:00.000Z",
    "website": {
      "id": 101,
      "url": "https://deinkunde.com"
    }
  }
]
```

Hinweis: Der List-Endpoint enthält nur die `website`-Relation (wenn `websiteId` gesetzt ist). Verschachtelte `customer`-Objekte und Monitor-Relationen sind in der Liste nicht enthalten. Für Anzeige und Filter steht stattdessen ein schlankes Top-Level-Feld `customerName` zur Verfügung.

## Häufige Fehler

- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf das Ziel hast