---
title: "List Query Runs"
method: GET
path: "/api/v1/dashboards/query-runs"
tags: ["dashboards"]
---

# List Query Runs

`GET /api/v1/dashboards/query-runs`

Published runs for this tenant, newest first, optionally scoped to a dashboard or
widget.

## Query parameters

- `dashboard_id` string, uuid, nullable
- `widget_id` string, uuid, nullable
- `limit` integer

## Response `200`

Successful Response

- QueryRunSummary[]
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `trigger` 'export' | 'scheduled_report' | 'locked_period' | 'doc' | 'spreadsheet', required
  - `assurance` 'result_preserved' | 'source_reproducible', required
  - `canonical_query_hash` string, required
  - `app_release` string, required
  - `source_as_of` string, date-time, nullable
  - `dashboard_id` string, uuid, nullable
  - `widget_id` string, uuid, nullable
  - `retention_until` string, date-time, nullable
  - `supersedes_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-09-04** `a9141b6e4e7e` — 1 warning
  - added the new `doc` enum value to the `items/trigger` response property for the response status `200`
- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/dashboards/query-runs/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/34f2d9e81b0b?raw)