Uptimeify Docs
OrganizationReports

Download Report PDF

Redirects to a short-lived signed URL for the archived PDF of a report run.

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

Redirects (302) to a time-limited, signed object-storage URL for the PDF archived for a report run. :id is the run's id (a UUID), as returned by List Report Runs. The run must belong to your organization. Available to any organization role, including read-only users.

Only runs with format: "email_pdf" that completed successfully archive a PDF — check hasPdf on the run before calling this endpoint. format: "email" runs, and runs that failed or were skipped, have no PDF and return 404.

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-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" \
  -L -o report.pdf

Response

302 Found with a Location header pointing at a signed, short-lived URL for the PDF object. No response body. Follow the redirect (-L in cURL, or your HTTP client's default redirect handling) to download the file.

Common errors

  • 401 Unauthorized — not authenticated.
  • 403 Forbidden (forbidden) — you do not have access to this organization.
  • 404 Not Found (reportRunNotFound) — no run with this id exists for your organization.
  • 404 Not Found (reportRunNoPdf) — the run has no archived PDF (it was an email-only report, or generation failed/was skipped).

On this page