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

# Search Folders

`GET /folders`

Returns JSON representation of the Folder tree

## Path parameters

- `folderId` integer, required

## Query parameters

- `folderName` string
- `exactFolderName` integer
- `homeFolderId` integer

## Response `200`

successful operation

- Folder[]
  - `id` integer — The ID of this Folder
  - `type` string — The type of folder (home or root)
  - `text` string — The name of this Folder
  - `parentId` integer — The folderId of the parent of this Folder
  - `isRoot` integer — Flag indicating whether this is root Folder
  - `children` string — An array of children folderIds
  - `createdDt` string, nullable — Date this Folder was created
  - `modifiedDt` string, nullable — Date this Folder was last modified

## Changes

- **2026-07-30** `fe497e811c7f` — 1 breaking, 2 warning, 3 info
  - added the new path request parameter `folderId`
  - deleted the `query` request parameter `folderId`
  - deleted the `query` request parameter `gridView`
  - added the new optional `query` request parameter `homeFolderId`
  - …2 more
- **2026-02-25** `41c04de98ec5` — 1 warning, 1 info
  - deleted the `path` request parameter `folderId`
  - added the media type `application/json` for the response with the status `200`
- **2024-07-24** `fa8d95dfe4bb` — 1 info
  - added the new optional `query` request parameter `exactFolderName`
- **2024-05-09** `6754c288e29a` — 1 breaking, 3 info
  - added the new path request parameter `folderId`
  - added the new optional `query` request parameter `folderId`
  - added the new optional `query` request parameter `folderName`
  - added the new optional `query` request parameter `gridView`
- **2021-11-17** `23e8e640f524` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/xibosignage/apis/xibo-api/changes/folders/get.md)

---

[API](https://skmtc.dev/xibosignage/apis/xibo-api.md) · [All operations](https://skmtc.dev/xibosignage/apis/xibo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xibosignage/xibo-api/revisions/9136e3c2cb1d/schema)