Skip to Content
Uptimeify Docs

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 die organizationId aus deiner Session verwendet.
  • source (optional): Filtert nach Incident-Quelle. manual liefert von einem Admin erstellte Statusseiten-Ankündigungen; monitor liefert 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 des limit-Fensters liegen würden.
  • limit (optional, Standard: 100, max: 500): Maximale Anzahl an Incidents.
  • offset (optional, Standard: 0): Pagination-Offset.
  • includeTotal (optional, Standard: 0): Wenn 1 (oder true), enthält die Response zusätzlich total, limit und offset.
  • onStatusPage (optional): true oder 1 liefert nur Vorfälle, die eine Statusseite als Vorfall zeigt: manuelle und solche, die mit einer Statusseite verknüpft sind. Andere Werte als true, false, 1, 0 antworten 400.

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 required wenn keine Organisation ermittelt werden kann
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keine Leserechte für die Organisation hast
  • 500 Failed to fetch incidents bei unerwarteten Fehlern

Auf dieser Seite