---
title: "Bericht-PDF herunterladen"
description: "Liefert das archivierte PDF eines Bericht-Laufs direkt im Response-Body."
---

`GET /api/organization/report-runs/:id/pdf`

Liefert das PDF, das für einen Bericht-Lauf archiviert wurde, direkt im Response-Body. `:id` ist die `id` des Laufs (eine UUID), wie sie von [Bericht-Läufe auflisten](/de/api/organization/reports/list-report-runs) zurückgegeben wird. Der Lauf muss zu Ihrer Organisation gehören. Verfügbar für jede Organisationsrolle, auch für **Nur-Lese**-Benutzer.

Die Bytes werden serverseitig aus dem Object Storage gelesen und an Sie zurückgegeben; das Objekt selbst wird nie als URL offengelegt, die Sitzungs-/Token-Prüfung bei diesem Aufruf ist damit die gesamte Zugriffskontrolle für die Datei.

Nur erfolgreich abgeschlossene Läufe mit `format: "email_pdf"` archivieren ein PDF. Prüfen Sie `hasPdf` beim Lauf, bevor Sie diesen Endpoint aufrufen. Läufe mit `format: "email"` sowie fehlgeschlagene oder übersprungene Läufe haben kein PDF und liefern `404`.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<ihr-api-token>"
RUN_ID="9a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

curl -X GET "$BASE_URL/api/organization/report-runs/$RUN_ID/pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -o bericht.pdf
```

## Antwort

`200 OK` mit den PDF-Bytes als Response-Body.

`Content-Type: application/pdf`, `Content-Disposition: attachment; filename="report-<period>.pdf"` (`<period>` wird aus dem Perioden-Label des Laufs abgeleitet, z. B. `report-08-2026.pdf`), `Cache-Control: private, max-age=300`, `X-Content-Type-Options: nosniff`.

## Häufige Fehler

- `401 Unauthorized`: nicht authentifiziert.
- `403 Forbidden` (`forbidden`): kein Zugriff auf diese Organisation.
- `404 Not Found` (`reportRunNotFound`): es existiert kein Lauf mit dieser ID für Ihre Organisation.
- `404 Not Found` (`reportRunNoPdf`): der Lauf hat kein archiviertes PDF (Nur-E-Mail-Bericht, oder die Erzeugung ist fehlgeschlagen bzw. wurde übersprungen).
- `404 Not Found` (`reportPdfNotFound`): der Lauf-Datensatz hat einen PDF-Pfad, aber das Objekt konnte nicht aus dem Object Storage gelesen werden.