---
title: "Search rooms"
method: GET
path: "/search"
tags: ["search"]
---

# Search rooms

`GET /search`

Full-text room search. Pass the query and options as query params here: ?q= (query), ?l= (limit), ?o= (offset), ?s= (sort), ?rt= (room type). The same handler also answers a positional path form for convenience, /search/{q}, /search/{q}/{l}, and so on up to /search/{q}/{l}/{o}/{s}/{rt}, filling those five slots left to right. An empty result set is a 204, not an empty 200.

## Query parameters

- `q` string
- `l` integer
- `o` integer
- `s` string
- `rt` string

## Response `200`

Matching rooms

- GithubComEtkeccMrsInternalModelEntry[]
  - `alias` string
  - `avatar` string
  - `avatar_url` string
  - `guest_can_join` boolean
  - `id` string
  - `join_rule` string
  - `language` string
  - `members` integer
  - `name` string
  - `room_type` string
  - `server` string — server of origin
  - `servers` string — comma-separated list of servers
  - `topic` string
  - `type` string
  - `world_readable` boolean

## Other responses

- `204` — No matches

---

[API](https://skmtc.net/etkecc/apis/matrix-rooms-search-api.md) · [All operations](https://skmtc.net/etkecc/apis/matrix-rooms-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etkecc/matrix-rooms-search-api/revisions/ae3c2fd65492/schema)