Playlists are curated track collections. They expose a name, optional curator metadata, optional description, artwork, and tracks.

List Playlists

GET /playlists?limit=25&offset=0&sort=name

The response is a List<Playlist>.

Look Up Playlists

Playlists can be looked up by id.

GET /playlists/lookup?ids=playlist_1,omm:playlist:playlist_2

Lookup requests should contain at most 100 ids.

Fetch One Playlist

GET /playlist/playlist_123

The response is Single<Playlist>.

Include Tracks

GET /playlist/playlist_123?include=tracks

Use scoped fields to shape the playlist and the included songs:

GET /playlist/playlist_123?include=tracks&fields[playlist]=name,description&fields[song]=name,durationMs

Relationship Endpoint

GET /playlist/playlist_123/rel/tracks

The tracks endpoint returns List<Song> and supports fields[song], limit, offset, and sort.