Plays by Device

Returns the track ids already played on a specific device for the logged-in user, as a simple string array. This reflects device-scoped play history used when the service enforces per-device play limits on free or limited subscription plans. The response contains identifiers only, not track metadata or remaining allowance counts.

Use this when: you need to check on limited plans before starting playback whether a track has already consumed this device's allowance. Combine with Get Play Remaining to show the user how many plays they have left and to gate the play button when the cap is reached. Use Play History when you need rich recently-played metadata for UI display rather than limit enforcement.

This endpoint is not yet implemented. Coming soon!

Security Model

oAuth