Get Information About The User's Current Playback

Developing

GET

/me/player

Get information about the user's current playback state, including track or episode, progress, and active device.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/me/player' \
--header 'Authorization;'

Response Example

200 - Example 1

{
    "actions": {
        "interrupting_playback": true,
        "pausing": true,
        "resuming": true,
        "seeking": true,
        "skipping_next": true,
        "skipping_prev": true,
        "toggling_repeat_context": true,
        "toggling_repeat_track": true,
        "toggling_shuffle": true,
        "transferring_playback": true
    },
    "context": {
        "external_urls": {
            "spotify": "string"
        },
        "href": "string",
        "type": "string",
        "uri": "string"
    },
    "currently_playing_type": "string",
    "device": {
        "id": "string",
        "is_active": true,
        "is_private_session": true,
        "is_restricted": true,
        "name": "string",
        "type": "string",
        "volume_percent": 0
    },
    "is_playing": true,
    "item": {
        "album": {
            "album_group": "string",
            "album_type": "string",
            "artists": [
                {
                    "external_urls": {
                        "spotify": "string"
                    },
                    "href": "string",
                    "id": "string",
                    "name": "string",
                    "type": "string",
                    "uri": "string"
                }
            ],
            "available_markets": [
                "string"
            ],
            "external_urls": {
                "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "images": [
                {
                    "height": 0,
                    "url": "string",
                    "width": 0
                }
            ],
            "name": "string",
            "release_date": "string",
            "release_date_precision": "string",
            "restrictions": {
                "reason": "string"
            },
            "total_tracks": 0,
            "type": "string",
            "uri": "string"
        },
        "artists": [
            {
                "external_urls": {
                    "spotify": "string"
                },
                "followers": {
                    "href": "string",
                    "total": 0
                },
                "genres": [
                    "string"
                ],
                "href": "string",
                "id": "string",
                "images": [
                    {
                        "height": 0,
                        "url": "string",
                        "width": 0
                    }
                ],
                "name": "string",
                "popularity": 0,
                "type": "string",
                "uri": "string"
            }
        ],
        "available_markets": [
            "string"
        ],
        "disc_number": 0,
        "duration_ms": 0,
        "explicit": true,
        "external_ids": {
            "ean": "string",
            "isrc": "string",
            "upc": "string"
        },
        "external_urls": {
            "spotify": "string"
        },
        "href": "string",
        "id": "string",
        "is_local": true,
        "is_playable": true,
        "linked_from": {
            "external_urls": {
                "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
        },
        "name": "string",
        "popularity": 0,
        "preview_url": "string",
        "restrictions": {
            "reason": "string"
        },
        "track_number": 0,
        "type": "string",
        "uri": "string"
    },
    "progress_ms": 0,
    "repeat_state": "string",
    "shuffle_state": "string",
    "timestamp": 0
}

Request

Query Params

Header Params

Responses

🟢200A successful request will return a `200 OK` response code with a json payload that contains information about the current playback. The information returned is for the last known state, which means an inactive device could be returned if it was the last o

application/json

Body

🟢204A successful request will return a `200 OK` response code with a json payload that contains information about the current playback. The information returned is for the last known state, which means an inactive device could be returned if it was the last o

🔴500500

Modified at 2022-09-12 10:04:50

Check if Users Follow a Playlist

Transfer a User's Playback