---
title: "Client well-known"
method: GET
path: "/.well-known/matrix/client"
tags: ["matrix-cs"]
---

# Client well-known

`GET /.well-known/matrix/client`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/etkecc/apis/matrix-rooms-search-api/docs/.well-known/matrix/client/get.ts> (a function with typed inputs; its response is checked against the schema)

The client well-known: the breadcrumb a Matrix client follows to find our homeserver base URL, because SRV records never quite caught on with clients. We only publish m.homeserver; no identity server, we are not that kind of server.

## Response `200`

Where a client should point its homeserver base URL

- GithubComEtkeccMrsInternalModelWellKnownClient
  - `m.homeserver` GithubComEtkeccMrsInternalModelWellKnownHomeserver
    - `base_url` string: e.g. https://matrix.example.com

## Changes

- **2026-07-08** `ae3c2fd65492`: 1 info
  - endpoint added
- **2024-08-20** `4009b08a3a5a`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/etkecc/apis/matrix-rooms-search-api/changes/.well-known/matrix/client/get.md)

---

[API](https://skmtc.dev/etkecc/apis/matrix-rooms-search-api.md) - [All operations](https://skmtc.dev/etkecc/apis/matrix-rooms-search-api/llms.txt) - [OpenAPI document](https://skmtc.dev/etkecc/apis/matrix-rooms-search-api/revisions/fafe2e40cd8c?raw)