---
title: "List Recent Runs"
method: GET
path: "/admin/scheduled/runs"
tags: ["Admin", "Scheduled Tasks"]
---

# List Recent Runs

`GET /admin/scheduled/runs`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/admin/scheduled/runs`
- Auth: none declared

Operator dashboard support — most-recent run records.

Returns the ``scheduled_task_runs`` rows newest-first. Optional
``task`` query param scopes to a single task name. When
``include_aggregates=true`` the response also embeds a 30-day
spend rollup the admin UI uses to render the "30-day spend" tile —
summing ``summary.credits_spent`` across every task whose summary
carries that key. Computed in-process; the row count is bounded
by ~30 days × ~5 daily tasks so a SELECT scan is fine.

## Query parameters

- `limit` integer
- `task` string, nullable
- `include_aggregates` boolean

## Headers

- `x-admin-secret` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)