---
title: "List task runs"
method: GET
path: "/task-runs"
tags: ["Workflow Tasks (Beta)"]
---

# List task runs

`GET /task-runs`

List task runs that match the provided filters. If no filters are provided, all task runs accessible by the authenticated user are returned.

## Query parameters

- `cursor` string
- `limit` integer — Defaults to 20
- `rootTaskRunId` string[]
- `ownerId` string[]

## Parameters

- `#/paths/~1tasks/parameters/1` — unresolved $ref
- `#/paths/~1tasks/parameters/2` — unresolved $ref
- `#/paths/~1tasks/parameters/3` — unresolved $ref

## Response `200`

List of task runs

- TaskRunWithCursor[]
  - `taskRun` object, required
    - `id` string, required
    - `taskId` string, required
    - `status` 'pending' | 'running' | 'completed' | 'succeeded' | 'failed' | 'canceled' | 'paused', required
    - `startedAt` string, date-time
    - `completedAt` string, date-time
    - `parentTaskRunId` string, required
    - `rootTaskRunId` string, required
    - `retries` integer, required
    - `attempts` object[], required
      - `status` Status, required — unresolved $ref
      - `enqueuedAt` string, date-time
      - `startedAt` string, date-time, required
      - `completedAt` string, date-time
  - `cursor` string, required

## Other responses

- `401` — Authorization information is missing or invalid.
- `403` — You do not have permissions for the requested resource.
- `404` — Unable to find the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)