---
title: "Bericht-Läufe auflisten"
description: "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](/de/api/organization/reports/send-report-now). 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

| Feld | Typ | Erforderlich | Hinweise |
|---|---|---|---|
| `reportId` | string (uuid) | nein | Beschränkt auf Läufe eines Berichts. Löst sich die ID nicht auf einen Bericht Ihrer Organisation auf, wird `[]` zurückgegeben. |
| `limit` | integer | nein | Standard `50`, begrenzt auf `200`. |
| `offset` | integer | nein | Standard `0`. |

## Beispiel (cURL)

```bash
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

```json
[
  {
    "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](/de/api/organization/reports/download-report-pdf) aufgerufen werden soll.

## Häufige Fehler

- `401 Unauthorized`: nicht authentifiziert.
- `403 Forbidden` (`forbidden`): kein Zugriff auf diese Organisation.