Get Available Devices

GET/me/player/devices

Get information about a user’s available Spotify Connect devices. Some device models are not supported and will not be listed in the API response.

ReturnsExpand Collapse

devices: array of DeviceObject { id, is_active, is_private_session, 6 more }

id: optional string

The device ID. This ID is unique and persistent to some extent. However, this is not guaranteed and any cached device_id should periodically be cleared out and refetched as necessary.

is_active: optional boolean

If this device is the currently active device.

is_private_session: optional boolean

If this device is currently in a private session.

is_restricted: optional 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: optional 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.

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

supports_volume: optional boolean

If this device can be used to set the volume.

type: optional string

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

volume_percent: optional number

The current volume in percent.

minimum0

maximum100

Get Available Devices

curl https://api.spotify.com/v1/me/player/devices \
    -H "Authorization: Bearer $SPOTIFY_ACCESS_TOKEN"

{
  "devices": [
    {
      "id": "id",
      "is_active": true,
      "is_private_session": true,
      "is_restricted": true,
      "name": "Kitchen speaker",
      "published": true,
      "supports_volume": true,
      "type": "computer",
      "volume_percent": 59
    }
  ]
}

Returns Examples

{
  "devices": [
    {
      "id": "id",
      "is_active": true,
      "is_private_session": true,
      "is_restricted": true,
      "name": "Kitchen speaker",
      "published": true,
      "supports_volume": true,
      "type": "computer",
      "volume_percent": 59
    }
  ]
}