Ausfall-Details abrufen
Gibt Details zu einem bestimmten Vorfall zurück.
GET /api/incidents/:incidentPublicId
Enthält neben den Incident-Basisdaten auch eine Timeline (Checks/Alert-Events) sowie optional einen Evidence-Check.
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
incidentPublicId(Path, required): Öffentliche UUID des Incidents.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/incidents/6bfec6f6-245a-47ce-843b-157d97d56f88" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Hinweis: evidenceCheck kann null sein. screenshotUrl ist nur gesetzt, wenn hasScreenshot true ist.
Auflösung der Timeline
timeline.outageChecks listet jeden Check zwischen der Bestätigung (confirmationAt, ausschließlich) und dem Ende des Vorfalls, fehlgeschlagene wie erfolgreiche, aufsteigend und auf 200 begrenzt; outageChecksTotal ist die volle Anzahl. Maßgeblich ist status je Eintrag: ein aggregierter Zeitraum ist failure, sobald darin ein Standort fehlgeschlagen ist.
Jeder Eintrag in outageStartedCheck, failedChecks, outageChecks und recoveryChecks trägt ein Feld resolution:
raw: eine einzelne Prüfung an einem einzelnen Standort.location,statusCodeunderrorMessagesind die Werte, die dieser Standort gemeldet hat.1min: eine Minute aus dem Monitoring-Aggregat. Sie wird verwendet, sobald ein Vorfall älter ist als die Aufbewahrungsfrist der Rohdaten (24 Stunden).location,statusCodeunderrorMessagesind dannnull,responseTimeMsist der Mittelwert der Minute, und zwei zusätzliche Felder nennen die Standorte dahinter:totalLocationsundfailedLocations.15minund1day: ein 15-Minuten- bzw. Tagesintervall, verwendet, sobald das Minutenaggregat nicht mehr zurückreicht (ab 7 Tagen15min, ab 30 Tagen1day). Dieselben Felder sindnullwie bei1min, die Zähler nennen aber einzelne Standort-Checks statt Standorte:totalChecksundfailedChecks.- Server- und DNS-Monitore (TCP, SSH, FTP, SMTP, IMAP/POP, ICMP, DNS) haben keine 15-Minuten-Stufe:
1minreicht 30 Tage zurück, ältere Vorfälle bekommen1day-Einträge mittotalChecksundfailedChecks.
Die id eines aggregierten Eintrags ist synthetisch (<resolution>-<Zeitstempel>, z. B. 1min-2026-09-01T10:00:00.000Z) und lässt sich nicht als Prüfung nachschlagen. Die vier Listen werden unabhängig voneinander aufgelöst; ein Vorfall, der eine Grenze überspannt, kann Auflösungen mischen.
Antwort (Auszug)
{
"incident": {
"id": 123,
"websiteId": 101,
"type": "downtime",
"status": "open",
"startedAt": "2026-02-26T12:10:00.000Z",
"resolvedAt": null,
"statusCode": null,
"errorMessage": "Timeout",
"responseTimeMs": null,
"falseAlarmAt": null,
"falseAlarmReason": null,
"publicTitle": null,
"publicStatus": "open",
"publicResolvedAt": null
},
"timeline": {
"outageStartedAt": "2026-02-26T12:08:00.000Z",
"outageStartedCheck": {
"id": "chk_01H...",
"checkedAt": "2026-02-26T12:08:00.000Z",
"status": "failure",
"statusCode": 503,
"errorMessage": "Timeout",
"responseTimeMs": null,
"location": { "id": 7, "code": "de-nbg", "name": "Nuremberg (DE)" },
"resolution": "raw"
},
"confirmationAt": "2026-02-26T12:10:00.000Z",
"failedChecks": [
{
"id": "1min-2026-02-26T12:09:00.000Z",
"checkedAt": "2026-02-26T12:09:00.000Z",
"status": "failure",
"statusCode": null,
"errorMessage": null,
"responseTimeMs": 246,
"location": null,
"resolution": "1min",
"totalLocations": 3,
"failedLocations": 2
}
],
"failedChecksTotal": 2,
"alertEvents": [
{
"id": 987,
"sentAt": "2026-02-26T12:11:00.000Z",
"type": "email",
"status": "sent",
"channelName": "Ops Email",
"errorMessage": null
}
],
"recoveryChecks": [],
"recoveryChecksTotal": 0,
"outageChecks": [],
"outageChecksTotal": 0
},
"evidenceCheck": {
"id": "chk_01H...",
"checkedAt": "2026-02-26T12:08:00.000Z",
"diagnostics": null,
"hasScreenshot": false,
"screenshotUrl": null
}
}Fehlalarm-Markierung
Ein Vorfall kann als Fehlalarm markiert werden (POST /api/incidents/{id}/false-alarm). Zwei
Felder auf incident geben diese Markierung wieder, nur lesend:
| Feld | Typ | Bedeutung |
|---|---|---|
falseAlarmAt | string | null | Wann markiert wurde, ISO 8601. null heißt: nicht markiert. |
falseAlarmReason | string | null | Der beim Markieren angegebene freie Grund, oder null. |
Die Markierung ist rücknehmbar, falseAlarmAt kann also wieder null werden. Sie ändert den
status nicht: ein als Fehlalarm markierter Vorfall ist trotzdem als Alarm hinausgegangen, und
genau das hält die Markierung fest.
Wer markiert hat, steht nicht in der Antwort.
Markieren und Zurücknehmen folgen derselben Schreibregel wie jede andere Änderung am Vorfall: im Kundenbereich des Vorfalls muss jede verknüpfte Statusseite es erlauben (organisationsweit admin oder editor; kundengebundene Aufrufer, auch mit der Rolle readonly, auf self_service-Seiten oder auf managed-Seiten mit der Ausnahme canEditManaged des Kunden, sonst 403 managed_by_organization). Ein Vorfall ohne verknüpfte Seite braucht admin oder editor.
Statusseiten-Verknüpfungen
statusPageLinks (seit 27. Oktober 2026) listet die Statusseiten und optional Komponenten, mit denen der Vorfall über Manuellen Vorfall anlegen oder Vorfall aktualisieren verknüpft ist: statusPageId, statusPagePublicId, statusPageName, componentId (null = seitenweit), componentPublicId, componentName und impact. Leer bei einem Vorfall, der nur über seinen Kunden oder Monitor erscheint. Einen manuellen Vorfall ohne Kunden lesen nur organisationsweite Rollen; ein kundengebundenes Login oder Token bekommt 404.
publicTitle, publicStatus und publicResolvedAt (seit 28. Oktober 2026) beschreiben den Vorfall, wie Statusseiten ihn zeigen. publicTitle ist der mit Vorfall aktualisieren gesetzte Titel für die Seiten 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 (ISO 8601).
postmortem (seit 28. Oktober 2026) ist die öffentliche Nachbetrachtung des Vorfalls, oder null, wenn keine geschrieben wurde: body (Markdown), publishedAt (null = Entwurf, nur im Statusseiten-Modul sichtbar) und updatedAt. Geschrieben wird sie mit Postmortem speichern, veröffentlicht mit Postmortem veröffentlichen.
Häufige Fehler
400 Incident public ID (UUID) requiredwenn:incidentPublicIdungültig ist401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn der Incident existiert, du aber keinen Zugriff hast404 Incident not foundwenn der Incident nicht existiert