---
title: "GET /v2/tasks"
method: GET
path: "/v2/tasks"
---

# GET /v2/tasks

`GET /v2/tasks`

Returns a list of tasks, filtering by ownership and/or status if given.

## Query parameters

- `createdBy` string[]
- `limit` integer
- `offset` integer
- `order` string[]
- `status` string[]

## Response `200`

Ok

- ListTasksResponse — The response shape for the `listTasks` call to the `scaffolder-backend`
  - `tasks` SerializedTask[], required
    - `id` string, required
    - `spec` object, required
    - `status` 'cancelled' | 'completed' | 'failed' | 'open' | 'processing' | 'skipped', required — The status of each step of the Task
    - `createdAt` string, required
    - `lastHeartbeatAt` string
    - `createdBy` string
  - `totalTasks` number

## Other responses

- `400` — An error response from the backend.

## Changes

- **2026-08-25** `7f53f7b1650b` — 1 info
  - added the non-success response with the status `400`
- **2026-08-19** `3dacb7325aa2` — 2 warning
  - removed the optional property `tasks/items/secrets` from the response with the `200` status
  - removed the optional property `tasks/items/state` from the response with the `200` status
- **2024-12-29** `34e9a2e690e7` — 2 breaking, 2 warning
  - for the `query` request parameter `limit`, the type/format was changed from `array`/`` to `integer`/``
  - for the `query` request parameter `offset`, the type/format was changed from `array`/`` to `integer`/``
  - for the `query` request parameter `limit`, the min was set to `0.00`
  - for the `query` request parameter `offset`, the min was set to `0.00`
- **2024-12-27** `e7ca0bc861d2` — 4 breaking, 2 warning, 6 info
  - removed the enum value `asc` from the `query` request parameter `order`
  - removed the enum value `desc` from the `query` request parameter `order`
  - the `tasks/items/secrets` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `tasks/items/spec` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - …8 more
- **2024-12-11** `11f61b547ea5` — 2 info
  - added the optional property `totalTasks` to the response with the `200` status
  - the response property `tasks` became required for the status `200`

[Full history](https://skmtc.dev/backstage/apis/scaffolder/changes/v2/tasks/get.md)

---

[API](https://skmtc.dev/backstage/apis/scaffolder.md) · [All operations](https://skmtc.dev/backstage/apis/scaffolder/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backstage/scaffolder/revisions/7f53f7b1650b/schema)