---
title: "Retrieve full folder structure"
method: GET
path: "/folder/structure"
tags: ["folder"]
---

# Retrieve full folder structure

`GET /folder/structure`

## Request

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

Retrieves the complete hierarchy of a folder and all its nested subfolders as a flat list.

## Query parameters

- `teamId` integer
- `folderId` integer, required

## Response `200`

Folder structure retrieved successfully.

- object
  - `items` FolderStructureItem[]: List of folders found in the hierarchy.
    - `id` integer, required
    - `name` string, required
    - `parentId` integer, nullable, required: ID of the parent folder (null for root).
  - `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)