Spotify Web API

Get a User's Available Devices

Developing

GET

/me/player/devices

category-player

Get information about a user's available devices.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/me/player/devices' \
--header 'Authorization;'

Response Example

200 - Example 1

{
  "devices": [
    {
      "id": "string",
      "is_active": true,
      "is_private_session": true,
      "is_restricted": true,
      "name": "string",
      "type": "string",
      "volume_percent": 0
    }
  ]
}

Request

Header Params

Authorization

string

required

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of a user. The access token must have the user-read-playback-state scope authorized in order to read information.

Responses

🟢200A successful request will return a `200 OK` response code with a json payload that contains the device objects (see below). When no available devices are found, the request will return a 200 OK response with an empty devices list.

application/json

Body

devices

array[object (DeviceObject) {7}]

optional

A list of 0..n Device objects

string

optional

The device ID.

is_active

boolean

optional

If this device is the currently active device.

is_private_session

boolean

optional

If this device is currently in a private session.

is_restricted

boolean

optional

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

optional

The name of the device.

type

string

optional

Device type, such as "computer", "smartphone" or "speaker".

volume_percent

integer <int32>

optional

The current volume in percent.

🔴500500

Modified at 2022-09-12 10:04:50

Get the User's Currently Playing Track

Skip User’s Playback To Next Track