Get Playback State
Get information about the user’s current playback state, including track or episode, progress, and active device.
The Spotify Platform can not be used to develop commercial streaming integrations.More information
The Spotify Platform can not be used to develop applications that alter Spotify Content.More information
You may not synchronize any sound recordings with any visual media, including any advertising, film, television program, slideshow, video, or similar contentMore information
The Spotify Platform can not be used for non-interactive broadcasting.More information
Read your currently playing content and Spotify Connect devices information.
An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.
If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.
Note: If neither market or user country are provided, the content is considered unavailable for the client.
Users can view the country that is associated with their account in the account settings.Example value:
A comma-separated list of item types that your client supports besides the default
tracktype. Valid types are:
Note: This parameter was introduced to allow existing clients to maintain their current behaviour and might be deprecated in the future.
In addition to providing this parameter, make sure that your client properly handles cases of new types in the future by checking against the
typefield of each object.
Information about playback
The device that is currently active.
The device ID.
If this device is the currently active device.
If this device is currently in a private session.
Whether controlling this device is restricted. At present if this is "true" then no Web API commands will be accepted by this device.
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 value:
Device type, such as "computer", "smartphone" or "speaker".Example value:
The current volume in percent.Example value:
off, track, context
If shuffle is on or off.
A Context Object. Can be
The object type, e.g. "artist", "playlist", "album", "show".
A link to the Web API endpoint providing full details of the track.
External URLs for this context.
Unix Millisecond Timestamp when data was fetched.
Progress into the currently playing track or episode. Can be
If something is currently playing, return
- itemoneOfWill be one of the following:
The currently playing track or episode. Can be
The object type of the currently playing item. Can be one of
Allows to update the user interface based on which playback actions are available within the current context.
Interrupting playback. Optional field.
Pausing. Optional field.
Resuming. Optional field.
Seeking playback location. Optional field.
Skipping to the next context. Optional field.
Skipping to the previous context. Optional field.
Toggling repeat context flag. Optional field.
Toggling shuffle flag. Optional field.
Toggling repeat track flag. Optional field.
Transfering playback between devices. Optional field.