---
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', 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

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/3ad158624c53/schema)