Market
OptionalTextSupply a text value for this input.
Example value (replace with your own):
US
In this guide
Get Playback State
Everything about the current session: track, device, volume, shuffle, repeat.
What this action does #
First, connect Spotify in Services. Then open Actions → + → Spotify and choose Get Playback State.
More about this action
Answers 204 with no body when nothing is playing and no device is active. That is a success, not an error — check `is_playing` rather than assuming a track is there.
Inputs to fill in #
Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.
Additional Types
OptionalTextAdd `episode` to see podcast playback as well as tracks.
What comes back #
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
is_playing | boolean | True or false. |
progress_ms | integer | Whole-number value. |
shuffle_state | boolean | True or false. |
repeat_state | string | off, track or context. |
device | object | A group of named values. |
device.id | string | Pass to any playback command to target this device. |
device.name | string | Text value. |
device.type | string | Text value. |
device.volume_percent | integer | Whole-number value. |
device.is_active | boolean | True or false. |
item | object | A group of named values. |
item.id | string | Text value. |
item.name | string | Text value. |
item.uri | string | Text value. |
item.duration_ms | integer | Whole-number value. |
item.artists | array | A list of values. |
item.artists[].name | string | Text value. |
Run it from Shortcuts #
- Give the action a recognizable name and tap Save.
- In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
- Supply any Param or File slots you bound in the inputs, then run the shortcut.
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
Advanced reference #
Request, permissions, and identifiers
Request: GET https://api.spotify.com/v1/me/player
Action identifier: spotify.player.state.get.v1
Permissions declared for this action: user-read-playback-state. The account’s own access rules also apply.
| Input | Request key | Location |
|---|---|---|
| Market | market | query |
| Additional Types | additional_types | query |