---
title: "List Folders"
method: GET
path: "/folders"
tags: ["Folders"]
---

# List Folders

`GET /folders`

List the folders.

## Query parameters

- `fields` string[]
- `limit` integer
- `offset` integer
- `sort` string[]
- `search` string
- `meta` string

## Response `200`

Successful request

- object
  - `data` Folders[]
    - `id` string — Unique identifier for the folder.
    - `name` string — Name of the folder.
    - `parent` union — Unique identifier of the parent folder. This allows for nested folders.
      - string
      - Folders — recursive
  - `meta` XMetadata
    - `total_count` integer — Returns the total item count of the collection you're querying.
    - `filter_count` integer — Returns the item count of the collection you're querying, taking the current filter/search parameters into account.

## Other responses

- `401` — Error: Unauthorized request
- `404` — Error: Not found.

---

[API](https://skmtc.dev/utomic-media/apis/dynamic-api-specification.md) · [All operations](https://skmtc.dev/utomic-media/apis/dynamic-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utomic-media/dynamic-api-specification/revisions/4a0ccd34700e/schema)