---
title: "Resolve a room alias (client)"
method: GET
path: "/_matrix/client/v3/directory/room/{room_alias}"
tags: ["matrix-cs"]
---

# Resolve a room alias (client)

`GET /_matrix/client/v3/directory/room/{room_alias}`

Turns a human-friendly room alias like #coffee:example.com into the actual room ID plus a list of servers that might know where it lives, because nobody memorizes a !opaque:id and clients still have to route the join somewhere. The r0 and v3 paths are the same handler; r0 is the legacy alias we keep alive for clients that never upgraded.

## Path parameters

- `room_alias` string, required

## Response `200`

Room ID and the servers that can help you join

- GithubComEtkeccMrsInternalModelQueryDirectoryResponse
  - `room_id` string
  - `servers` string[]

## Other responses

- `404` — We could not resolve that alias

---

[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/versions/ae3c2fd65492/schema)