---
title: "List root drive sub-folders"
method: GET
path: "/drive_folders"
tags: ["Drive Folders"]
---

# List root drive sub-folders

`GET /drive_folders`

List all top-level sub-folders under the firm's root drive folder. Results are paginated using `page` and `per_page` parameters.

## Query parameters

- `page` integer
- `per_page` 10 | 100 | 200 | 500

## Response `200`

Successfully returns paginated list of drive folders

- object
  - `data` DriveFolder[]
    - `id` integer
    - `name` string
    - `client_visible` boolean
    - `entity_id` integer, nullable
    - `path` string — Full path to the folder from the root (e.g. "/Root/2024/Client")
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagy` PagyMetadata — Pagination metadata (Pagy)
    - `count` integer — Total number of items
    - `page` integer — Current page number
    - `items` integer — Number of items per page
    - `pages` integer — Total number of pages
    - `prev` integer, nullable — Previous page number (null if none)
    - `next` integer, nullable — Next page number (null if none)

## Other responses

- `400` — Invalid pagination parameters (e.g. page out of range) or drive not activated

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/7c956b3d1bdf/schema)