Skip to content
Announcement: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 APIReferences / 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    }  ]}