Get Recently Played Tracks
Get tracks from the current user's recently played tracks. Note: Currently doesn't support podcast episodes.
Authorization
oauth_2_0 user-read-recently-playedSpotify supports OAuth 2.0 for authenticating all API requests.
In: header
Scope: user-read-recently-played
Query Parameters
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
1 <= value <= 5020A Unix timestamp in milliseconds. Returns all items
after (but not including) this cursor position. If after is specified, before
must not be specified.
A Unix timestamp in milliseconds. Returns all items
before (but not including) this cursor position. If before is specified,
after must not be specified.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/me/player/recently-played"{ "href": "string", "limit": 0, "next": "string", "cursors": { "after": "string", "before": "string" }, "total": 0, "items": [ { "track": { "album": { "album_type": "compilation", "total_tracks": 9, "available_markets": [ "CA", "BR", "IT" ], "external_urls": { "spotify": "string" }, "href": "string", "id": "2up3OPMp9Tb4dAKM2erWXQ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "name": "string", "release_date": "1981-12", "release_date_precision": "year", "restrictions": { "reason": "market" }, "type": "album", "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ", "artists": [ { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "name": "string", "type": "artist", "uri": "string" } ] }, "artists": [ { "external_urls": { "spotify": "string" }, "followers": { "href": "string", "total": 0 }, "genres": [ "Prog rock", "Grunge" ], "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "name": "string", "popularity": 0, "type": "artist", "uri": "string" } ], "available_markets": [ "string" ], "disc_number": 0, "duration_ms": 0, "explicit": true, "external_ids": { "isrc": "string", "ean": "string", "upc": "string" }, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "is_playable": true, "linked_from": { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "type": "string", "uri": "string" }, "restrictions": { "reason": "string" }, "name": "string", "popularity": 0, "preview_url": "string", "track_number": 0, "type": "track", "uri": "string", "is_local": true }, "played_at": "2019-08-24T14:15:22Z", "context": { "type": "string", "href": "string", "external_urls": { "spotify": "string" }, "uri": "string" } } ]}Toggle Playback Shuffle PUT
Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.
Get the User's Queue GET
Get the list of objects that make up the user's queue.