Get songs for a smartlist

This returns the songs for a smartlist

get/smartlists/{smartlist_id}/songs

Path parameters

smartlist_idstring required

Unique identifier of the smartlist.

Query parameters

random0 | 1

offsetinteger

Return results starting from this index position

limitinteger

Maximum number of results to return

Response

Song list

total_countinteger required

md5string required

Changes

Changed in 10 of the 46 revisions of this API.1314

Aug 9, 2026535feee32afb1See the full diff
- ○
  added the required property song/items/mood to the response with the 200 status
  response-required-property-added
Aug 7, 2026b152883a37a31See the full diff
- ○
  added the required property song/items/bpm to the response with the 200 status
  response-required-property-added
Jul 28, 202648f80d018de41See the full diff
- ○
  added the required property song/items/last_played to the response with the 200 status
  response-required-property-added
Jul 22, 2026e8e6b266ea295See the full diff
- ○
  api operation id smartlistSongs was added
  api-operation-id-added
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  added the non-success response with the status 500
  response-non-success-status-added
Jul 19, 2026b874092765cd12See the full diff
- ▲
  the response property song/items/album/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/album/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/album/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/albumartist/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/albumartist/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/albumartist/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artist/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artist/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artist/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artists/items/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artists/items/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property song/items/artists/items/prefix became nullable for the status 200
  response-property-became-nullable
Jul 18, 20260366bc42fb8f3See the full diff
- ○
  added the required property md5 to the response with the 200 status
  response-required-property-added
- ○
  added the required property song to the response with the 200 status
  response-required-property-added
- ○
  added the required property total_count to the response with the 200 status
  response-required-property-added
Jul 17, 20269abb9bf6d3bf1See the full diff
- ○
  removed the non-success response with the status 400
  response-non-success-status-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 25, 20267ed7a764efd91See the full diff
- ○
  added the non-success response with the status 400
  response-non-success-status-added
Feb 24, 20263c57979a295f1See the full diff
- ○
  endpoint added
  endpoint-added
Feb 19, 202607f53972fdd71See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation

Full history