Skip to content
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.