---
title: "List registered devices for the current user"
method: GET
path: "/_matrix/client/v3/devices"
tags: ["Device management"]
---

# List registered devices for the current user

`GET /_matrix/client/v3/devices`

## Request

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

Gets information about all devices for the current user.

## Response `200`

Device information

- object
  - `devices` object[]: A list of all registered devices for this user.
    - `device_id` string, required: Identifier of this device.
    - `display_name` string: Display name set by the user for this device. Absent if no name has been set.
    - `last_seen_ip` string: The IP address where this device was last seen. (May be a few minutes out of date, for efficiency reasons).
    - `last_seen_ts` integer: The timestamp (in milliseconds since the unix epoch) when this devices was last seen. (May be a few minutes out of date, for efficiency reasons).

---

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