We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.

Web API •References / Player / Get Available Devices

Get Available 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.

Authorization scopes

Request

GET

/me/player/devices

Response

A set of devices

Required
- id
  string
  Nullable
  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
  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.
  Example: "Kitchen speaker"
- type
  string
  Device type, such as "computer", "smartphone" or "speaker".
  Example: "computer"
- volume_percent
  integer
  Nullable
  The current volume in percent.
  Range: 0 - 100Example: 59
- supports_volume
  boolean
  If this device can be used to set the volume.

Response sample

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