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

# List folders

`GET /folder`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/folder`
- Auth: HTTP basic

Retrieves a paginated list of folders residing in a specific folder.

## Query parameters

- `teamId` integer
- `folderId` integer, required
- `page` integer, required
- `limit` integer, required
- `names` string[]

## Response `200`

Folder list retrieved successfully.

- object
  - `items` FolderItem[]: List of folders in the current page.
    - `entityId` number: Folder ID
    - `entityName` string: Folder Name
  - `itemsCounter` integer: Total number of items available.
  - `existsNext` boolean: True if more pages of results are available.

## Other responses

- `default`: Standard error response.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)