Ausfälle auflisten (Organisation)
Listet Incidents für eine Organisation auf. Die Daten sind durch deine Session/Permissions eingeschränkt.
GET /api/incidents?organizationId=:organizationId
Readonly-User sehen nur Incidents für Kunden, denen sie zugewiesen sind.
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Query Parameter
organizationId(optional): Wenn nicht gesetzt, wird dieorganizationIdaus deiner Session verwendet.source(optional): Filtert nach Incident-Quelle.manualliefert von einem Admin erstellte Statusseiten-Ankündigungen;monitorliefert automatisch von den Monitoring-Workern erzeugte Incidents. Jeder andere Wert wird ignoriert und alle Quellen werden zurückgegeben. Nützlich, da manuelle Incidents deutlich älter sein können als die neuesten Monitor-Incidents und sonst außerhalb deslimit-Fensters liegen würden.limit(optional, Standard:100, max:500): Maximale Anzahl an Incidents.offset(optional, Standard:0): Pagination-Offset.includeTotal(optional, Standard:0): Wenn1(odertrue), enthält die Response zusätzlichtotal,limitundoffset.onStatusPage(optional):trueoder1liefert nur Vorfälle, die eine Statusseite als Vorfall zeigt: manuelle und solche, die mit einer Statusseite verknüpft sind. Andere Werte alstrue,false,1,0antworten400.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/incidents?organizationId=1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Pagination:
curl -X GET "$BASE_URL/api/incidents?organizationId=1&limit=100&offset=0" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Nur manuell erstellte (Statusseiten-)Incidents auflisten:
curl -X GET "$BASE_URL/api/incidents?organizationId=1&source=manual" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Antwort (Auszug)
[
{
"id": 123,
"websiteId": 101,
"status": "open",
"severity": "downtime",
"startedAt": "2026-02-26T12:10:00.000Z",
"resolvedAt": null,
"lastNotifiedAt": "2026-02-26T12:11:00.000Z",
"errorMessage": "Timeout",
"statusCode": null,
"responseTimeMs": null,
"website": {
"id": 101,
"name": "Main Marketing Site",
"url": "https://deinkunde.com",
"status": "active"
},
"customer": {
"id": 12,
"email": "ops@deinkunde.com",
"company": "Acme Corp"
}
}
]Wenn includeTotal=1, ändert sich das Response-Format zu:
{
"incidents": [],
"total": 1234,
"limit": 100,
"offset": 0
}statusPages (seit 28. Oktober 2026): jeder Eintrag trägt [{ "id", "publicId", "name" }], die Statusseiten, auf denen der Vorfall als Vorfall steht: verknüpfte Seiten und bei einem manuellen Vorfall mit Kunde die Seiten dieses Kunden. Leer für einen nicht verknüpften Monitor-Vorfall.
publicTitle, publicStatus, publicResolvedAt (seit 28. Oktober 2026): der Vorfall, wie Statusseiten ihn zeigen. publicTitle ist der für die Seiten gesetzte Titel oder null (die Seiten zeigen dann title). publicStatus ist open oder resolved; bei einem Monitor-Vorfall setzen ihn Timeline-Updates unabhängig von status, sonst folgt er status. publicResolvedAt ist der Zeitpunkt, zu dem er auf den Seiten behoben wurde.
Abgelöste Felder: started_at, resolved_at, last_notified_at, error_message, status_code und response_time_ms werden bis zum Entfall am 18.01.2027 weiter neben startedAt, resolvedAt, lastNotifiedAt, errorMessage, statusCode und responseTimeMs geliefert, mit und ohne includeTotal. Lies die camelCase-Felder.
Manuelle Vorfälle ohne Kunden
Seit dem 27. Oktober 2026 kann ein manueller Vorfall ohne Kunden angelegt werden, nur mit Statusseiten verknüpft. Die Liste enthält ihn für organisationsweite Rollen und Tokens mit customer: null; ein kundengebundenes Login oder Token sieht ihn nicht.
Häufige Fehler
400 Organization ID is requiredwenn keine Organisation ermittelt werden kann401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keine Leserechte für die Organisation hast500 Failed to fetch incidentsbei unerwarteten Fehlern