---
title: "Get tasks"
method: GET
path: "/public/v1/tasks"
tags: ["Task"]
---

# Get tasks

`GET /public/v1/tasks`

Lists the tasks belonging to the authenticated company, oldest-first (by creation time). Results
never cross company boundaries and are paginated: `next_page` holds the URL of the following
page, or null on the last page.

A task may be linked to exactly one other entity. The linked entity is returned as the matching
relation field (`order`, `invoice`, `purchase`, `contact`, `product`, `batch`, `assembly`,
`return`, or `company`); every other relation field is null. Tasks linked to an internal-only
entity that has no public API model return every relation field as null.

Required permission: `tasks_permissions_view`.

## Query parameters

- `ids` string[]
- `owner_ids` string[]
- `statuses` string[]
- `related_types` string[]
- `due_datetime` string
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of tasks

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

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