---
title: "Get task lists"
method: GET
path: "/api/v2/task_lists"
tags: ["Task Lists"]
---

# Get task lists

`GET /api/v2/task_lists`

Returns a paginated list of task lists — the task groupings inside a project's folders. By default, task lists that belong to project templates are excluded; filtering by a specific project returns its task lists even when that project is a template. Supports filtering by project, folder, status, and free-text query, and sorting by board, folder, project, or company name.

## Query parameters

- `filter` union — Filter schema for `task_list` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterTaskList — Filter parameters for listing task lists. Supports filtering by project, board (folder), archived status, and position. Standard ID operators apply.
    - `project_id` union — Filter by project ID.
      - ProjectId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `query` union — Filter by task list name (text search).
      - Query — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
    - `id` union — Filter by task list ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
    - `restorable` union — Filter to task lists that are archived but whose parent folder is still active (can be restored).
      - object — Filter using explicit operator syntax.
        - `not_eq` Restorable — unresolved $ref
        - `contains` Restorable — unresolved $ref
        - `eq` Restorable — unresolved $ref
        - `not_contain` Restorable — unresolved $ref
      - Restorable — unresolved $ref
    - `status` union — Filter by task list status (active or archived).
      - object — Filter using explicit operator syntax.
        - `not_eq` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `contains` Status — unresolved $ref
      - Status — unresolved $ref
    - `folder_id` union — Filter by folder ID (alias for board_id).
      - object — Filter using explicit operator syntax.
        - `eq` FolderId — unresolved $ref
        - `contains` FolderId — unresolved $ref
        - `not_eq` FolderId — unresolved $ref
        - `not_contain` FolderId — unresolved $ref
      - FolderId — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection task list

---

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