---
title: "Gets the versions of the specification supported by the server."
method: GET
path: "/_matrix/client/versions"
tags: ["Server administration"]
---

# Gets the versions of the specification supported by the server.

`GET /_matrix/client/versions`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/versions`
- Auth: one of:
  - none
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets the versions of the specification supported by the server.

Values will take the form `vX.Y` or `rX.Y.Z` in historical cases. See
[the Specification Versioning](../#specification-versions) for more
information.

The server may additionally advertise experimental features it supports
through `unstable_features`. These features should be namespaced and
may optionally include version information within their name if desired.
Features listed here are not for optionally toggling parts of the Matrix
specification and should only be used to advertise support for a feature
which has not yet landed in the spec. For example, a feature currently
undergoing the proposal process may appear here and eventually be taken
off this list once the feature lands in the spec and the server deems it
reasonable to do so. Servers can choose to enable some features only for
some users, so clients should include authentication in the request to
get all the features available for the logged-in user. If no
authentication is provided, the server should only return the features
available to all users. Servers may wish to keep advertising features
here after they've been released into the spec to give clients a chance
to upgrade appropriately. Additionally, clients should avoid using
unstable features in their stable releases.

## Response `200`

The versions supported by the server.

- object
  - `unstable_features` object: Experimental features the server supports. Features not listed here, or the lack of this property all together, indicate that a feature is not supported.
  - `versions` string[], required: The supported versions.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)