---
title: "List All Task Runs"
method: GET
path: "/public/v1/task-runs"
tags: ["public"]
---

# List All Task Runs

`GET /public/v1/task-runs`

## Request

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

## Query parameters

- `limit` integer
- `offset` integer
- `status` string, nullable: Filter by run status (PENDING, RUNNING, COMPLETED, FAILED, CANCELLED)
- `taskId` string, nullable: Filter by task ID
- `since` string, nullable: ISO 8601 timestamp. Only return runs created after this time. Defaults to 7 days ago.
- `until` string, nullable: ISO 8601 timestamp. Only return runs created before this time.

## Headers

- `Authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/komos/apis/komos-backend.md) · [All operations](https://skmtc.dev/komos/apis/komos-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/komos/apis/komos-backend/revisions/f10e153fab38?raw)