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

# List tasks

`GET /v1/tasks`

List organization Operator Tasks with pagination and filters. Filter by Make, SKU / retail alias, or linked Print Job.

## Query parameters

- `limit` number
- `offset` number
- `page` number
- `swimlane_id` string
- `model_id` string
- `make_id` string
- `print_job_id` integer
- `sku_alias` string
- `assigned_to` string
- `priority` 'low' | 'medium' | 'high'
- `tags` union
  - string
  - string[]
- `archived` boolean

## Response `200`

Default Response

- object
  - `tasks` object[]
  - `total` number

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-25** `6f1a23af942d` — 3 info
  - added the new optional `query` request parameter `make_id`
  - added the new optional `query` request parameter `print_job_id`
  - added the new optional `query` request parameter `sku_alias`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/tasks/get.md)

---

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