Uptimeify Docs
OrganisationBerichte

Bericht-Läufe auflisten

Gibt die Erzeugungs-/Zustellhistorie der Organisationsberichte zurück, optional gefiltert auf einen einzelnen Bericht.

GET /api/organization/report-runs

Listet Bericht-Läufe der Organisation, neueste zuerst. Ein Lauf wird bei jeder Erzeugung eines Berichts angelegt — geplant oder über Bericht sofort senden. Die Organisation wird aus Ihrer authentifizierten Sitzung oder Ihrem API-Token abgeleitet. Verfügbar für jede Organisationsrolle, auch für Nur-Lese-Benutzer.

Query-Parameter

FeldTypErforderlichHinweise
reportIdstring (uuid)neinBeschränkt auf Läufe eines Berichts. Löst sich die ID nicht auf einen Bericht Ihrer Organisation auf, wird [] zurückgegeben.
limitintegerneinStandard 50, begrenzt auf 200.
offsetintegerneinStandard 0.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/organization/report-runs?reportId=3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90&limit=20" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort

[
  {
    "id": "9a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "reportId": "3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90",
    "reportName": "Wöchentlicher Ops-Bericht",
    "periodStart": "2026-05-25T00:00:00.000Z",
    "periodEnd": "2026-06-01T00:00:00.000Z",
    "periodLabel": "25. Mai – 1. Juni 2026",
    "status": "sent",
    "trigger": "schedule",
    "sentAt": "2026-06-01T02:00:12.000Z",
    "recipients": ["ops@agentur.io"],
    "hasPdf": true,
    "summary": { "sitesIncluded": 42, "incidents": 3 },
    "createdAt": "2026-06-01T02:00:00.000Z"
  }
]

status ist einer von pending, generating, sent, failed, skipped_empty. trigger ist schedule oder manual. hasPdf ist nur true, wenn für diesen Lauf ein PDF archiviert wurde — nutzen Sie es, um zu entscheiden, ob Bericht-PDF herunterladen aufgerufen werden soll.

Häufige Fehler

  • 401 Unauthorized — nicht authentifiziert.
  • 403 Forbidden (forbidden) — kein Zugriff auf diese Organisation.

Auf dieser Seite