---
title: "List folders"
method: GET
path: "/v1/design_studio/folders"
tags: ["Design Studio"]
---

# List folders

`GET /v1/design_studio/folders`

Returns a paginated list of folders. This does not include files like emails, components, etc.

## Query parameters

- `page` integer
- `limit` integer
- `parent_folder_id` string, uuid
- `direct_descendants_only` boolean
- `sort_by` 'created' | 'updated' | 'name'
- `sort_order` 'asc' | 'desc'
- `created_before` integer
- `created_after` integer
- `updated_before` integer
- `updated_after` integer

## Response `200`

Successful response

- object
  - `folders` Folder[]
    - `id` string, uuid — ID of folder
    - `name` string — The name of the folder.
    - `parent_folder_id` string, uuid, nullable — The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer — Timestamp of when the folder was created.
    - `updated` integer — Timestamp of last update to the folder.
  - `meta` ListMeta
    - `pagination` object
      - `page` integer — The page number of results you're on.
      - `limit` integer — The number of results per page.
      - `total` integer — The total number of folders.
    - `filters` object — The filters applied in your request.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)