Query for the room ID and resident homeservers for a room alias

GET {{baseUrl}}/query/directory?room_alias=%23room_alias:example.org

Performs a query to get the mapped room ID and list of resident homeservers in the room for a given room alias. Homeservers should only query room aliases that belong to the target server (identified by the DNS Name in the alias).

Servers may wish to cache the response to this query to avoid requesting the information too often.

Request Params

KeyDatatypeRequiredDescription
room_aliasstring(Required) The room alias to query.

RESPONSES

status: OK

{"room_id":"!roomid1234:example.org","servers":["example.org","example.com","another.example.com:8449"]}