Skip to content
Announcement:REMINDER : We are updating the criteria to be granted extended access to the Web API.
Submit your extended quota mode application by May 15th. 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.

endpointhttps://api.spotify.com/v1/me/player/devices

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    }  ]}