---
title: "Wartungsfenster abrufen"
description: "Gibt ein einzelnes Wartungsfenster anhand der ID zurück (inkl. Target-Relation)."
---

`GET /api/maintenance-windows/:id`

## Authentifizierung

Erfordert eine gültige Session.

- Header: `Authorization: Bearer <token>`

Hinweis (API-Token Scope): Wenn du ein Customer-scoped API-Token nutzt, muss das Wartungsfenster zu diesem Kunden gehören.

## Parameter

- `id` (Path, required): Wartungsfenster-ID.

## Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/maintenance-windows/5" \
  -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,
  "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: Je nach Ziel kann die Response stattdessen auch eine dieser Relationen enthalten: `icmpMonitor`, `smtpMonitor`, `sshMonitor`, `ftpMonitor`, `imapPopMonitor`. Verschachtelte `customer`-Objekte werden nicht zurückgegeben.

## Häufige Fehler

- `400 Invalid maintenance window ID` wenn `:id` ungültig ist
- `404 Maintenance window not found` wenn das Fenster nicht existiert
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf das Ziel/den Kunden hast
- `500 Maintenance window target is missing` wenn kein gültiges Ziel am Wartungsfenster hinterlegt ist