---
title: "Advanced search for folders"
method: GET
path: "/folders/search"
tags: ["Browsing, Indexes and Lists", "Search"]
---

# Advanced search for folders

`GET /folders/search`

## Request

- Base URL: `https://develop.ampache.dev/rest/8/json`
- URL: `https://develop.ampache.dev/rest/8/json/folders/search`
- Auth: one of:
  - HTTP bearer
  - API key in header `auth`
  - API key in query parameter `auth`

Provide operator plus one or more rule triplets. At minimum, rule_1, rule_1_operator, rule_1_input are required. Additional rules may be supplied as rule_2, rule_2_operator, rule_2_input, etc. A rule may also carry rule_<n>_group (int) to combine it with other rules sharing that id under group_<id>_operator (and/or), instead of the top-level operator -- exactly two levels, group ids are not nested.

## Query parameters

- `operator` 'and' | 'or', required
- `random` boolean
- `offset` integer
- `limit` integer
- `rule_1` string, required
- `rule_1_operator` string, required
- `rule_1_input` string, required
- `rule_2` string
- `rule_2_operator` string
- `rule_2_input` string
- `rule_3` string
- `rule_3_operator` string
- `rule_3_input` string
- `rule_1_group` integer
- `rule_2_group` integer
- `rule_3_group` integer
- `group_1_operator` 'and' | 'or'

## Response `200`

Search results

- FoldersResponse
  - `total_count` integer, required
  - `md5` string, required
  - `folder` FolderObject[], required
    - `id` string, required
    - `name` string, nullable, required
    - `parent` string, nullable, required
    - `path` string, nullable, required
    - `catalog` string, required
    - `time` integer, required
    - `items` integer, required
    - `playable` boolean, required
    - `art` string, nullable, required
    - `has_art` boolean, required
    - `flag` boolean, required
    - `rating` integer, nullable, required
    - `averagerating` number, nullable, required

## Other responses

- `400`: HTTP 400 Bad Request (errors 4705, 4710).
- `401`: HTTP 401 Unauthorized (error 4701).
- `403`: HTTP 403 Forbidden (errors 4700, 4703, 4742).
- `500`: HTTP 500 Internal Server Error (error 4702).

## Changes

- **2026-10-27** `7e3d431e8627`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/folders/search/get.md)

---

[API](https://skmtc.dev/ampache/apis/ampache-rest-api.md) - [All operations](https://skmtc.dev/ampache/apis/ampache-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ampache/apis/ampache-rest-api/revisions/7e3d431e8627?raw)