Reports

Get report run history

Lists the runs of scheduled reports from the organization's triggers stream: scheduled and manual runs, their outcome, recipients and timing. The full path is /api/v2/{org_id}/reports/history.

get/api/v2/{org_id}/reports/history

Request

Path parameters

org_idstring required

Organization name

Query parameters

report_idstring

Report ID (KSUID); omit for every report

run_report_idstring

Exact run's report ID (KSUID); requires GET access to that report

start_timeinteger

Start time in Unix microseconds (default: 7 days ago)

end_timeinteger

End time in Unix microseconds (default: now)

statusstring[]

Repeatable: succeeded, error, skipped

trigger_sourcestring

scheduled or manual

is_cachedboolean

true for cache-warming runs, false for emailed runs

frominteger

Pagination offset (default: 0)

sizeinteger

Page size (default: 100, max: 1000)

retriesinteger

Exact retry index for a shared run link

sort_bystring

_timestamp, status, end_time or retries (default: _timestamp)

sort_orderstring

asc or desc (default: desc)

Response

Success

disabled_reasonstring nullable

Why the org records no run rows: own-org reporting off, remote mode or an expired trial.

frominteger required
sizeinteger required
totalinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.