---
title: "Search for media entities using rule triplets"
method: GET
path: "/users/search"
tags: ["Users", "Search"]
---

# Search for media entities using rule triplets

`GET /users/search`

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.

## 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

## Response `200`

Search results

- object

## Other responses

- `400` — Invalid request

## Changes

- **2026-07-14** `aaf4166bdf3a` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-06-25** `7ed7a764efd9` — 1 info
  - added the media type `application/json` for the response with the status `400`
- **2026-05-11** `b515694fd82a` — 2 info
  - api tag `Search` added
  - api tag `Users` added
- **2026-02-26** `c3f202b17eb7` — 1 info
  - endpoint added
- **2026-02-19** `07f53972fdd7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/users/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-service-production.skmtc.workers.dev/v1/apis/ampache/ampache-rest-api/revisions/aff89ca1eeff/schema)