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; Max100). Wird beiformat=csvoderdownload=1durch die Export-Defaults ersetzt (Default10000, Max50000).status(string, optional):open,acknowledgedoderresolved.type(string, optional):downtime,http_status,ssl_expiry,ssl_critical,ssl_warning,response_time,dnsbl,domain_expiry_warning,criticaloderinconclusive.from/to(ISO-Datumsstring, optional): Filter nachstartedAt-Bereich.format(string, optional):json(Default) odercsv.download(string, optional):1erzwingt einen Attachment-Download,0(Default) liefert die Seite.envelope(string, optional):itemsliefert 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) requiredwenn:websitePublicIdungültig ist400 Bad Request(invalidRequestBody) wenn ein Query-Parameter ungültig ist:page/limitkeine positive Ganzzahl,formatwederjsonnochcsv,downloadweder0noch1, oder ein unbekannter Wert instatusodertype400 Bad Request(invalidDateRange) wennfromodertokein Datum ist401 Unauthorizedwenn du nicht angemeldet bist403 Forbiddenwenn du keinen Zugriff auf den Monitor hast