Albums12

Artists7

Artwork7

Authentication5

Bookmarks17

Browsing, Indexes and Lists13

Catalogs17

Collections8

Genres6

Labels5

Licenses3

Live Streams5

Localplay1

Maintenance4

Now Playing6

Playback Control18

Playlist Folders8

Playlists18

Podcasts13

Preferences7

Ratings and Flags18

Search2

Shares13

Social6

Song1

Songs8

Streaming and Downloads9

Users7

Utilities7

Videos3

Songs

Get song by ID

returns a single song

get/songs/{song_id}

Path parameters

song_idstring required

Unique identifier of the song.

Response

Song details

idstring required

titlestring nullable required

namestring nullable required

diskinteger required

disksubtitlestring nullable required

bpmnumber nullable required

trackinteger required

filenamestring nullable required

playlisttrackinteger required

timeinteger required

yearinteger required

formatstring nullable required

stream_formatstring nullable required

bitrateinteger nullable required

stream_bitrateinteger nullable required

rateinteger required

modestring nullable required

mimestring nullable required

stream_mimestring nullable required

urlstring required

sizeinteger required

mbidstring nullable required

artstring nullable required

has_artboolean required

flagboolean required

ratinginteger nullable required

averageratingnumber nullable required

playcountinteger required

last_playedstring nullable required

catalogstring required

composerstring nullable required

channelsinteger nullable required

commentstring nullable required

licensestring nullable required

publisherstring nullable required

languagestring nullable required

lyricsstring nullable required

replaygain_album_gainnumber nullable required

replaygain_album_peaknumber nullable required

replaygain_track_gainnumber nullable required

replaygain_track_peaknumber nullable required

r128_album_gainnumber nullable required

r128_track_gainnumber nullable required

metadataobject

Changes

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

Aug 9, 2026535feee32afb1See the full diff
- ○
  added the required property mood to the response with the 200 status
  response-required-property-added
Aug 7, 2026b152883a37a31See the full diff
- ○
  added the required property bpm to the response with the 200 status
  response-required-property-added
Jul 28, 202648f80d018de41See the full diff
- ○
  added the required property last_played to the response with the 200 status
  response-required-property-added
Jul 22, 2026e8e6b266ea295See the full diff
- ○
  api operation id song 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 album/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property album/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property album/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property albumartist/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property albumartist/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property albumartist/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artist/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artist/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artist/prefix became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artists/items/basename became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artists/items/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property artists/items/prefix became nullable for the status 200
  response-property-became-nullable
Jul 18, 20260366bc42fb8f47See the full diff
- ○
  added the optional property albumartist to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property metadata to the response with the 200 status
  response-optional-property-added
- ○
  added the required property album to the response with the 200 status
  response-required-property-added
- ○
  added the required property art to the response with the 200 status
  response-required-property-added
- ○
  added the required property artist to the response with the 200 status
  response-required-property-added
- ○
  added the required property artists to the response with the 200 status
  response-required-property-added
- ○
  added the required property averagerating to the response with the 200 status
  response-required-property-added
- ○
  added the required property bitrate to the response with the 200 status
  response-required-property-added
- ○
  added the required property catalog to the response with the 200 status
  response-required-property-added
- ○
  added the required property channels to the response with the 200 status
  response-required-property-added
- ○
  added the required property comment to the response with the 200 status
  response-required-property-added
- ○
  added the required property composer to the response with the 200 status
  response-required-property-added
- ○
  added the required property disk to the response with the 200 status
  response-required-property-added
- ○
  added the required property disksubtitle to the response with the 200 status
  response-required-property-added
- ○
  added the required property filename to the response with the 200 status
  response-required-property-added
- ○
  added the required property flag to the response with the 200 status
  response-required-property-added
- ○
  added the required property format to the response with the 200 status
  response-required-property-added
- ○
  added the required property genre to the response with the 200 status
  response-required-property-added
- ○
  added the required property has_art to the response with the 200 status
  response-required-property-added
- ○
  added the required property id to the response with the 200 status
  response-required-property-added
- ○
  added the required property language to the response with the 200 status
  response-required-property-added
- ○
  added the required property license to the response with the 200 status
  response-required-property-added
- ○
  added the required property lyrics to the response with the 200 status
  response-required-property-added
- ○
  added the required property mbid to the response with the 200 status
  response-required-property-added
- ○
  added the required property mime to the response with the 200 status
  response-required-property-added
- ○
  added the required property mode to the response with the 200 status
  response-required-property-added
- ○
  added the required property name to the response with the 200 status
  response-required-property-added
- ○
  added the required property playcount to the response with the 200 status
  response-required-property-added
- ○
  added the required property playlisttrack to the response with the 200 status
  response-required-property-added
- ○
  added the required property publisher to the response with the 200 status
  response-required-property-added
- ○
  added the required property r128_album_gain to the response with the 200 status
  response-required-property-added
- ○
  added the required property r128_track_gain to the response with the 200 status
  response-required-property-added
- ○
  added the required property rate to the response with the 200 status
  response-required-property-added
- ○
  added the required property rating to the response with the 200 status
  response-required-property-added
- ○
  added the required property replaygain_album_gain to the response with the 200 status
  response-required-property-added
- ○
  added the required property replaygain_album_peak to the response with the 200 status
  response-required-property-added
- ○
  added the required property replaygain_track_gain to the response with the 200 status
  response-required-property-added
- ○
  added the required property replaygain_track_peak to the response with the 200 status
  response-required-property-added
- ○
  added the required property size to the response with the 200 status
  response-required-property-added
- ○
  added the required property stream_bitrate to the response with the 200 status
  response-required-property-added
- ○
  added the required property stream_format to the response with the 200 status
  response-required-property-added
- ○
  added the required property stream_mime to the response with the 200 status
  response-required-property-added
- ○
  added the required property time to the response with the 200 status
  response-required-property-added
- ○
  added the required property title to the response with the 200 status
  response-required-property-added
- ○
  added the required property track to the response with the 200 status
  response-required-property-added
- ○
  added the required property url to the response with the 200 status
  response-required-property-added
- ○
  added the required property year 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