---
title: "List Query Folders"
method: GET
path: "/data/projects/{projectId}/queries/folders"
tags: ["Data -- Query Folders"]
---

# List Query Folders

`GET /data/projects/{projectId}/queries/folders`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/queries/folders`
- Auth: HTTP bearer

Returns all query folders belonging to the given project as a flat list.

## Path parameters

- `projectId` string, required

## Response `200`

Folders listed successfully

- QueryFolderListResponse: Response containing a list of query folders
  - `items` QueryFolderItem[]: List of folders in the project
    - `id` string: Unique identifier of the folder (UUID)
    - `name` string: Display name of the folder
    - `path` string: Full path of the folder in the hierarchy
    - `parentId` string: ID of the parent folder, null if root-level
    - `createdAt` string: Timestamp when the folder was created (ISO 8601)

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)