---
title: "Get Available Devices"
method: GET
path: "/me/player/devices"
tags: ["Player"]
---

# Get Available Devices

`GET /me/player/devices`

Get information about a user’s available devices.

## Response `200`

A set of devices

- DevicesObject
  - `devices` DeviceObject[] — A list of 0..n Device objects
    - `id` string, nullable — The device ID.
    - `is_active` boolean — If this device is the currently active device.
    - `is_private_session` boolean — If this device is currently in a private session.
    - `is_restricted` boolean — Whether controlling this device is restricted. At present if this is "true" then no Web API commands will be accepted by this device.
    - `name` string — A human-readable name for the device. Some devices have a name that the user can configure (e.g. \"Loudest speaker\") and some devices have a generic name associated with the manufacturer or device model.
    - `type` string — Device type, such as "computer", "smartphone" or "speaker".
    - `volume_percent` integer, nullable — The current volume in percent.

## Other responses

- `401` — Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.
- `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.
- `429` — The app has exceeded its rate limits.

---

[API](https://skmtc.net/spotify/apis/sonallux.md) · [All operations](https://skmtc.net/spotify/apis/sonallux/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotify/sonallux/versions/1459b27f2e48/schema)