Skip to Content
Uptimeify Docs

Ausfälle auflisten

Gibt die Incident-Historie einer Website zurück (letzte 100), inklusive berechneter Dauer.

GET /api/websites/:websitePublicId/incident-history

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Parameter

  • websitePublicId (Pfad, erforderlich): Öffentliche UUID der Website.

Query Parameter

  • page (number, optional): Seite (Default: 1).
  • limit (number, optional): Einträge pro Seite (Default: 25; Max 100). Wird bei format=csv oder download=1 durch die Export-Defaults ersetzt (Default 10000, Max 50000).
  • status (string, optional): open, acknowledged oder resolved.
  • type (string, optional): downtime, http_status, ssl_expiry, ssl_critical, ssl_warning, response_time, dnsbl, domain_expiry_warning, critical oder inconclusive.
  • from / to (ISO-Datumsstring, optional): Filter nach startedAt-Bereich.
  • format (string, optional): json (Default) oder csv.
  • download (string, optional): 1 erzwingt einen Attachment-Download, 0 (Default) liefert die Seite.
  • envelope (string, optional): items liefert die Antwort als { items, total, page, perPage }. Ab 18.01.2027 Standard.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/websites/11111111-1111-4111-8111-111111111111/incident-history?envelope=items" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Beispiel-Antwort

{
  "items": [
    {
      "id": 123,
      "publicId": "55555555-5555-4555-8555-555555555555",
      "type": "downtime",
      "status": "resolved",
      "startedAt": "2026-02-26T12:10:00.000Z",
      "endedAt": "2026-02-26T12:12:30.000Z",
      "durationMs": 150000,
      "statusCode": null,
      "errorMessage": "connect ETIMEDOUT",
      "details": "connect ETIMEDOUT",
      "isOngoing": false
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 25
}

Listenform: Mit envelope=items kommt die Liste als { items, total, page, perPage } (perPage ist das limit). Ohne den Parameter antwortet der Endpunkt noch in der bisherigen Form { data, total, page, pageCount }; sie ist veraltet, ab dem 18.01.2027 ist { items, ... } der Standard.

Abgelöstes Feld: duration (Text, z. B. 2m 30s) wird bis zum Entfall am 18.01.2027 weiter neben durationMs geliefert. Lies durationMs.

status ist open, acknowledged oder resolved. Laufende Vorfälle haben ein null bei endedAt und isOngoing: true.

Bei format=csv (oder download=1) ist die Response ein text/csv-Attachment (bzw. application/json bei format=json&download=1) anstelle der paginierten JSON-Antwort oben.

Häufige Fehler

  • 400 Website public ID (UUID) required wenn :websitePublicId ungültig ist
  • 400 Bad Request (invalidRequestBody) wenn ein Query-Parameter ungültig ist: page/limit keine positive Ganzzahl, format weder json noch csv, download weder 0 noch 1, oder ein unbekannter Wert in status oder type
  • 400 Bad Request (invalidDateRange) wenn from oder to kein Datum ist
  • 401 Unauthorized wenn du nicht angemeldet bist
  • 403 Forbidden wenn du keinen Zugriff auf den Monitor hast

Auf dieser Seite