Deutsch English

Wartungsfenster auflisten

GET /api/v1/maintenances

Nur geplante Fenster; ungeplante Ereignisse liegen unter /incidents.

Erforderliche Berechtigung

incidents.manage Vorfälle und Wartungen verwalten

Body Parameter (application/json)

Name Format Beschreibung Optional
page integer
per_page integer Wird auf die maximale Seitengröße begrenzt statt abgewiesen.
status
state Veröffentlichungs-Lebenszyklus, im Unterschied zum Arbeitsstatus.
active boolean Veröffentlicht und noch nicht abgeschlossen.
since string Untere Grenze für started_at.
until string Obere Grenze für started_at.
component_id integer
q string Groß-/Kleinschreibung-unabhängige Teilstring-Suche über Titel und Text in allen Sprachen.

Response (application/json)

200 
{3 Eigenschaften
  "links": {4 Eigenschaften
    "first": "https://status.example.com/api/v1/maintenances?page=1",
    "last": "https://status.example.com/api/v1/maintenances?page=1",
    "prev": null,
    "next": null
  },
  "meta": {4 Eigenschaften
    "current_page": 1,
    "per_page": 25,
    "total": 1,
    "last_page": 1
  },
  "data": [1 Element
    {19 Eigenschaften
      "id": 12,
      "type": "incident",
      "status": "investigating",
      "title": {2 Eigenschaften
        "de": "Störung im Netz",
        "en": "Network issue"
      },
      "body": {2 Eigenschaften
        "de": "Wir untersuchen erhöhte Latenzen.",
        "en": null
      },
      "started_at": "2026-07-27T13:55:00Z",
      "scheduled_end_at": null,
      "published_at": "2026-07-27T14:00:00Z",
      "publish_at": "2026-07-27T14:00:00Z",
      "resolved_at": null,
      "acknowledged_at": null,
      "is_published": true,
      "is_scheduled": false,
      "is_resolved": false,
      "components": [1 Element
        {2 Eigenschaften
          "id": 3,
          "impact": "degraded"
        }
      ],
      "public_url": "https://status.example.com/incidents/12",
      "updates": [],
      "created_at": "2026-07-27T14:00:00Z",
      "updated_at": "2026-07-27T14:00:00Z"
    }
  ]
}

cURL

curl -X GET 'https://status.example.com/api/v1/maintenances' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY'