---
title: "List File Folders"
method: GET
path: "/api/v1/file-folders"
tags: ["file-folders"]
---

# List File Folders

`GET /api/v1/file-folders`

List FileFolders. Default = direct children of ``parent_folder_id``.

The flat-list mode is preserved for clients that haven't been migrated to
nested navigation yet (the current frontend on ``main`` consumes a flat
list); they pass ``flat=true`` and get every folder back.

## Query parameters

- `parent_folder_id` string, uuid, nullable — If provided, return only direct children of this folder. Use the special value 'root' (encoded as missing) to list root folders.
- `flat` boolean — If true, return every folder in the company (legacy flat view). When false (default) the response is scoped to direct children of ``parent_folder_id`` (or the root level if omitted).

## Response `200`

Successful Response

- FileFolderRead[]
  - `id` string, required
  - `name` string, required
  - `parent_folder_id` string, nullable
  - `merge_enabled` boolean, required
  - `schema_mode` string, required
  - `merge_database_id` string, nullable, required
  - `write_semantics` string
  - `coverage_columns` string[], nullable
  - `coverage_granularity` string
  - `batch_key_pattern` string, nullable
  - `batch_size` integer, nullable
  - `batch_timeout_hours` number, nullable
  - `sealed_batch_key` string, nullable
  - `member_count` integer
  - `has_children` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)