Get Currently Playing Track
Get the object currently being played on the user's Spotify account.
The Spotify Platform can not be used to develop commercial streaming integrations.
More informationThe Spotify Platform can not be used to develop applications that alter Spotify Content.
More informationYou may not synchronize any sound recordings with any visual media, including any advertising, film, television program, slideshow, video, or similar content
More informationThe Spotify Platform can not be used for non-interactive broadcasting.
More information
Read your currently playing content.
Request
- marketstring
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:"ES"
- additional_typesstring
A comma-separated list of item types that your client supports besides the default
track
type. Valid types are:track
andepisode
.
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 thetype
field of each object.
Response
Information about the currently playing track
The device that is currently active.
- idstringNullable
The device ID.
- is_activeboolean
If this device is the currently active device.
- is_private_sessionboolean
If this device is currently in a private session.
- is_restrictedboolean
Whether controlling this device is restricted. At present if this is "true" then no Web API commands will be accepted by this device.
- namestring
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:"Kitchen speaker"
- typestring
Device type, such as "computer", "smartphone" or "speaker".
Example value:"computer"
- volume_percentintegerNullable
The current volume in percent.
Example value:59
Range:0
-100
- repeat_statestring
off, track, context
- shuffle_stateboolean
If shuffle is on or off.
A Context Object. Can be
null
.- typestring
The object type, e.g. "artist", "playlist", "album", "show".
- hrefstring
A link to the Web API endpoint providing full details of the track.
External URLs for this context.
- uristring
The Spotify URI for the context.
- timestampinteger
Unix Millisecond Timestamp when data was fetched.
- progress_msinteger
Progress into the currently playing track or episode. Can be
null
. - is_playingboolean
If something is currently playing, return
true
. - itemoneOfWill be one of the following:
The currently playing track or episode. Can be
null
. - currently_playing_typestring
The object type of the currently playing item. Can be one of
track
,episode
,ad
orunknown
. Allows to update the user interface based on which playback actions are available within the current context.
- interrupting_playbackboolean
Interrupting playback. Optional field.
- pausingboolean
Pausing. Optional field.
- resumingboolean
Resuming. Optional field.
- seekingboolean
Seeking playback location. Optional field.
- skipping_nextboolean
Skipping to the next context. Optional field.
- skipping_prevboolean
Skipping to the previous context. Optional field.
- toggling_repeat_contextboolean
Toggling repeat context flag. Optional field.
- toggling_shuffleboolean
Toggling shuffle flag. Optional field.
- toggling_repeat_trackboolean
Toggling repeat track flag. Optional field.
- transferring_playbackboolean
Transfering playback between devices. Optional field.