---
title: "Get Folder List"
method: GET
path: "/v3.0/folders/"
tags: ["folders"]
---

# Get Folder List

`GET /v3.0/folders/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/folders/`
- Auth: none declared. Required headers: `x-api-key`

Get a list of user's forms' folders.

Use `?pagination=0` to get all folders

## Query parameters

- `exclude_branch` string
- `page` integer
- `parent_folder` string
- `search` string
- `type` string

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Response `200`

- PaginatedFolderList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `page_size` integer
  - `page_count` integer
  - `current_page` integer
  - `folders` Folder[]
    - `subfolders_count` string
    - `slug` string, nullable
    - `parent_folder` string, nullable: If the folder has a parent folder, send its slug on this field.
    - `subfolders` string
    - `shared_access` string
    - `icon_url` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `title` string, required: title of the folder.
    - `color` string, nullable: folder color settings or color code.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)