---
title: "Get folders"
method: GET
path: "/api/v2/folders"
tags: ["Folders"]
---

# Get folders

`GET /api/v2/folders`

Returns a paginated list of folders — the top-level groupings inside a project that hold its task lists. Supports filtering by project, status, and free-text query.

## Query parameters

- `sort` string[]
- `filter` union — A root filter object for folder list requests, supporting both a grouped filter with logical operators and a flat filter object.
  - FilterFolder — Filter parameters for listing folders.
    - `status` union — Filter by folder archive status.
      - object — Filter folder status using a specific comparison operator.
        - `not_contain` Status — unresolved $ref
        - `contains` Status — unresolved $ref
        - `not_eq` Status — unresolved $ref
        - `eq` Status — unresolved $ref
      - Status — unresolved $ref
    - `project_id` union — Filter by the ID of the project the folder belongs to.
      - ProjectId — unresolved $ref
      - object — Filter project ID using a specific comparison operator.
        - `eq` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `query` union — Filter by folder name using a text search query.
      - Query — unresolved $ref
      - object — Filter folder name using a specific comparison operator.
        - `eq` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
    - `id` union — Filter by folder ID.
      - object — Filter folder ID using a specific comparison operator.
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `eq` Id — unresolved $ref
      - Id — unresolved $ref
  - object — A grouped filter object that combines multiple folder filter conditions using a logical operator.
    - `$op` 'or' | 'and', required — The logical operator used to combine filter conditions. Accepted values are 'and' and 'or'.

## Headers

- `X-Organization-Id` string, required

## Response `200`

A paginated collection of folder resources.

---

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