---
title: "List tasks"
method: GET
path: "/api/v1/tasks"
tags: ["Tasks"]
---

# List tasks

`GET /api/v1/tasks`

## Query parameters

- `page` integer
- `limit` integer
- `status` 'waiting' | 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'expired'
- `kind` 'cad' | 'model' | 'convert-simple' | 'convert-advanced' | 'pipeline' | 'compound'

## Response `200`

Paginated task list

- SuccessResponseTaskList
  - `ok` true
  - `data` object
    - `tasks` TaskDetail[]
      - `taskId` string, uuid, required
      - `kind` 'cad' | 'model' | 'convert-simple' | 'convert-advanced' | 'pipeline' | 'compound', required
      - `label` string, required
      - `status` 'waiting' | 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'expired', required
      - `progress` number, nullable
      - `error` string, nullable
      - `resultParts` object, nullable
      - `metadata` object, nullable
      - `createdAt` string, date-time, required
      - `startedAt` string, date-time, nullable
      - `finishedAt` string, date-time, nullable
      - `expiresAt` string, date-time, required
    - `page` integer
    - `limit` integer
    - `total` integer

## Changes

- **2026-04-17** `5eb4ed0f33c7` — 19 breaking, 4 warning, 8 info
  - the response property `data/tasks/items/error` became nullable for the status `200`
  - the response property `data/tasks/items/finishedAt` became nullable for the status `200`
  - the response property `data/tasks/items/metadata` became nullable for the status `200`
  - the response property `data/tasks/items/progress` became nullable for the status `200`
  - …27 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/tasks/get.md)

---

[API](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api.md) · [All operations](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbybit-dev/bitbybit-cad-cloud-api/revisions/5eb4ed0f33c7/schema)