List report runs

Returns report run status, output details, ranges, formats and pagination.

GET https://app.upfour.io/v1/reports/runs

Authorization

AuthorizationA pls_ key. It stays in this browser tab. Needs report.read.

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request

Responsenot sent yet

Fill in a key and press Send request (⌘↵).
The answer appears here.

scope report.read stable returns 200

Returns

A successful request returns 200 with application/json.

Response fields 2 top-level fields

Field Type Description

data ReportRun[] · nullable

Each item · 23 fields

Field Type Description

created_at string (date-time)

format string one ofcsvjsonpdfxlsx

id uuid

organization_id uuid

params object · nullable free-form keys The parameters the report was rendered with.

range_from string (date-time)

range_to string (date-time)

report_type string one ofexecutive_summarysummarymonitor_reportmonitorsmonitor_slaslaincident_analyticsincidentsresponse_timeresponse-timedowntime_ledgerdowntime-ledgertrends

status string one ofpendingrunningretryingsucceededfailed

client_id uuid

completed_at string (date-time)

content_hash string

delivery ReportDeliveryStatus Mail delivery of a scheduled run; absent for downloads.

ReportDeliveryStatus · 4 fields

Field	Type	Description
`attempts`	integer
`sent`	integer
`total`	integer
`next_attempt_at`	string (date-time)

error string Why a run failed or was skipped.

output_bytes integer

output_sha256 string

requested_by uuid

schedule_id uuid

storage_key string

pagination Pagination

Pagination · 5 fields

Field	Type	Description
`cursor`	string · nullable
`has_more`	boolean
`limit`	integer 1–250
`next_cursor`	string · nullable
`prev_cursor`	string · nullable

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status	Code	Meaning
400	`bad_request`	The request is malformed or fails validation.
403	`permission_denied`	The credentials do not permit this action.

Every call can also return unauthorized (401), rate_limit_exceeded (429) or internal_error (500 / 502). See Responses and errors.

package main import ( "fmt" "io" "net/http" "os" ) func main() { req, _ := http.NewRequest("GET", "https://app.upfour.io/v1/reports/runs", nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("UP4_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(res.StatusCode, string(out)) }

<?php $ch = curl_init("https://app.upfour.io/v1/reports/runs"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("UP4_API_KEY"), ], ]); $response = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), " ", $response, "\n"; curl_close($ch);

{ "data": [ { "content_hash": "721378bc96ef2ddece4a66b447ba60d6a1266860d9cb23f4e0e6c152f30279cb", "created_at": "2026-10-27T09:00:00Z", "delivery": { "attempts": 1, "next_attempt_at": "2026-10-27T09:00:00Z", "sent": 0, "total": 1 }, "error": "1 recipient(s) could not be reached: anna@example.com: email delivery is not configured", "format": "pdf", "id": "00000000-0000-4000-8000-000000000001", "organization_id": "00000000-0000-4000-8000-000000000002", "output_bytes": 18432, "output_sha256": "3c8dc35de8b20338c83d488ff7e387f6ff1542a8747f8aa45665c4bacefe149a", "params": { "from": "2026-10-20T09:00:00Z", "lang": "en", "preset": "7d", "scope": { "HideCompanyLevel": false, "ID": "00000000-0000-4000-8000-000000000003", "Mode": 1, "TeamVisibleClientIDs": null }, "timezone": "Europe/Berlin", "to": "2026-10-27T09:00:00Z" }, "range_from": "2026-10-20T09:00:00Z", "range_to": "2026-10-27T09:00:00Z", "report_type": "summary", "requested_by": "00000000-0000-4000-8000-000000000004", "schedule_id": "00000000-0000-4000-8000-000000000005", "status": "retrying", "storage_key": "example/reports/v1/00000000-0000-4000-8000-000000000002/00000000-0000-4000-8000-000000000001.pdf" }, { "completed_at": "2026-10-27T09:00:00Z", "content_hash": "67720e645b28c194f156531039886954216b868a49b6b75701842fc7ca1e80ee", "created_at": "2026-10-27T09:00:00Z", "format": "json", "id": "00000000-0000-4000-8000-000000000006", "organization_id": "00000000-0000-4000-8000-000000000002", "params": { "from": "2026-09-27T09:00:00Z", "preset": "30d", "scope": { "HideCompanyLevel": false, "ID": "00000000-0000-4000-8000-000000000003", "Mode": 1, "TeamVisibleClientIDs": null }, "timezone": "UTC", "to": "2026-10-27T09:00:00Z" }, "range_from": "2026-09-27T09:00:00Z", "range_to": "2026-10-27T09:00:00Z", "report_type": "monitor_report", "requested_by": "00000000-0000-4000-8000-000000000004", "status": "succeeded" }, { "completed_at": "2026-10-27T09:00:00Z", "content_hash": "1a6f66d8015109dd9fad363cb57981130e563515228285185bcdf1bff74ebb8d", "created_at": "2026-10-27T09:00:00Z", "format": "csv", "id": "00000000-0000-4000-8000-000000000007", "organization_id": "00000000-0000-4000-8000-000000000002", "params": { "from": "2026-09-27T09:00:00Z", "preset": "30d", "scope": { "HideCompanyLevel": false, "ID": "00000000-0000-4000-8000-000000000003", "Mode": 1, "TeamVisibleClientIDs": null }, "timezone": "UTC", "to": "2026-10-27T09:00:00Z" }, "range_from": "2026-09-27T09:00:00Z", "range_to": "2026-10-27T09:00:00Z", "report_type": "monitor_report", "requested_by": "00000000-0000-4000-8000-000000000004", "status": "succeeded" }, { "completed_at": "2026-10-27T09:00:00Z", "content_hash": "ed686270eb166d01c13673f8f7e9cccb4c08251cea4f1a25809307f592b32a44", "created_at": "2026-10-27T09:00:00Z", "format": "json", "id": "00000000-0000-4000-8000-000000000008", "organization_id": "00000000-0000-4000-8000-000000000002", "params": { "from": "2026-09-27T09:00:00Z", "preset": "30d", "scope": { "HideCompanyLevel": false, "ID": "00000000-0000-4000-8000-000000000003", "Mode": 1, "TeamVisibleClientIDs": null }, "timezone": "UTC", "to": "2026-10-27T09:00:00Z" }, "range_from": "2026-09-27T09:00:00Z", "range_to": "2026-10-27T09:00:00Z", "report_type": "downtime_ledger", "requested_by": "00000000-0000-4000-8000-000000000004", "status": "succeeded" } ], "pagination": { "cursor": null, "has_more": false, "limit": 50, "next_cursor": null, "prev_cursor": null } }