---
title: "Query if a given registration token is still valid."
method: GET
path: "/_matrix/client/v1/register/m.login.registration_token/validity"
tags: ["Account management"]
---

# Query if a given registration token is still valid.

`GET /_matrix/client/v1/register/m.login.registration_token/validity`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v1/register/m.login.registration_token/validity`
- Auth: none declared
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v1/register/m.login.registration_token/validity/get.ts> (a function with typed inputs; its response is checked against the schema)

Queries the server to determine if a given registration token is still
valid at the time of request. This is a point-in-time check where the
token might still expire by the time it is used.

Servers should be sure to rate limit this endpoint to avoid brute force
attacks.

## Query parameters

- `token` string, required

## Response `200`

The check has a result.

- object
  - `valid` boolean, required: True if the token is still valid, false otherwise. This should additionally be false if the token is not a recognised token by the server.

## Other responses

- `403`: The homeserver does not permit registration and thus all tokens are considered invalid.
- `429`: This request was rate-limited.

---

[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)