Get Source/Client
const url = 'https://example.com/api/components/example';const options = {method: 'GET', headers: {cookie: 'ms.session_token=<ms.session_token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/components/example \ --cookie ms.session_token=<ms.session_token>Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”Success
object
General state of the component like Idle, Stopped, Running, Error
More specific, live activity state like “sleeping”, “hydrating historical scrobbles”, “processing dead scrobbles”, etc…
object
object
Unique tuple identifying user and device
Full play/scrobble object information
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
object
Original data from the Source the play was created from
The play before any transforms were applied
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
Scrobble action plus the match result before scrobbling
object
Outcome of matching this Play against existing scrobbles
object
Did the play matxh an existing play?
Confidence of match, out of ~100. 90+ is high confidence
Score calculation summaries for each Play part analyzed
Why or why not the play matched
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
Raw/json payload sent to the downstream scrobble service
Anomalies returned from the scrobble service, or detected by MS, that did not stop scrobbling but look suspicious
Raw/json response from the scrobble service
If service responded with data, the result of merging this corrected data into MS’s play
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
ISO8601 timestamp
Last time play was updated in MS
Last time player self-reported it was updated at
When this specific play/player was created
Player position, in seconds
Seconds the current track has been listened to
If player is mirroring generic now-playing (from upstream LZ/LFM client)
Status of player
object
What player reported: paused, playing, stopped, unknown
What MS has derived from watching player behavior: paused, playing, stopped, unknown
When player has not reported any new updates for N seconds
When player has not reported any new updates for N * 2 seconds
object
Number of discovered/scrobbled plays found in real time
Number of discovered/scrobbled plays from backlog/jobs
Seconds of discovered plays (sources only)
object
General state of the component like Idle, Stopped, Running, Error
More specific, live activity state like “sleeping”, “hydrating historical scrobbles”, “processing dead scrobbles”, etc…
object
object
Unique tuple identifying user and device
Full play/scrobble object information
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
object
Original data from the Source the play was created from
The play before any transforms were applied
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
Scrobble action plus the match result before scrobbling
object
Outcome of matching this Play against existing scrobbles
object
Did the play matxh an existing play?
Confidence of match, out of ~100. 90+ is high confidence
Score calculation summaries for each Play part analyzed
Why or why not the play matched
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
Raw/json payload sent to the downstream scrobble service
Anomalies returned from the scrobble service, or detected by MS, that did not stop scrobbling but look suspicious
Raw/json response from the scrobble service
If service responded with data, the result of merging this corrected data into MS’s play
object
object
object
object
object
object
object
object
object
object
object
object
object
object
The length of the track, in seconds
The date the track was played at
When the track finished playing
Number of seconds the track was listened to
Ranges of the track that were listened to
object
object
Position in the track, in seconds
Position in the track, as a percentage of duration
object
Position in the track, in seconds
Position in the track, as a percentage of duration
Play was detected as a repeat of the previous play
object
Type of Source that discovered this play
When Multi-Scrobbler first saw this play
If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)
Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…
Unique ID for this track, given by the Source
Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”
object
The URL where this track can be found for the service it was created from. IE Spotify Source = url to spotify track, Maloja Client = url to specific scrobble
The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video
The position the “player” is at in the track at the time the play was reported, in seconds
Name of the media player (program)
Version of the media player (program)
A unique identifier for the device playing this track
The ID/Key for individual sessions on a device/platform
Was the component activitely monitoring when this Play was created?
ISO8601 timestamp
Last time play was updated in MS
Last time player self-reported it was updated at
When this specific play/player was created
Player position, in seconds
Seconds the current track has been listened to
If player is mirroring generic now-playing (from upstream LZ/LFM client)
Status of player
object
What player reported: paused, playing, stopped, unknown
What MS has derived from watching player behavior: paused, playing, stopped, unknown
When player has not reported any new updates for N seconds
When player has not reported any new updates for N * 2 seconds
When a now playing that is not realtime is cleared
object
Number of discovered/scrobbled plays found in real time
Number of discovered/scrobbled plays from backlog/jobs
Seconds of discovered plays (sources only)
Example
{ "mode": "source", "state": 1, "players": { "additionalProperty": { "play": { "data": { "track": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] }, "artists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "albumArtists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "album": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } }, "meta": { "sourceSOT": "player", "parsedFrom": "backlog", "scrobbleTsSOC": 1 }, "original": { "play": { "data": { "track": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] }, "artists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "albumArtists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "album": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } }, "meta": { "sourceSOT": "player", "parsedFrom": "backlog", "scrobbleTsSOC": 1 } } }, "scrobble": { "match": { "closestMatchedPlay": { "data": { "track": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] }, "artists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "albumArtists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "album": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } }, "meta": { "sourceSOT": "player", "parsedFrom": "backlog", "scrobbleTsSOC": 1 } }, "transformedPlay": { "data": { "track": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] }, "artists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "albumArtists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "album": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } }, "meta": { "sourceSOT": "player", "parsedFrom": "backlog", "scrobbleTsSOC": 1 } }, "createdAt": "2026-11-13T14:05:00.000Z" }, "mergedScrobble": { "data": { "track": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] }, "artists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "albumArtists": [ { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } ], "album": { "metadata": [ { "name": "musicbrainz", "idType": "recording" } ] } }, "meta": { "sourceSOT": "player", "parsedFrom": "backlog", "scrobbleTsSOC": 1 } } } }, "playFirstSeenAt": "2026-11-13T14:05:00.000Z", "playLastUpdatedAt": "2026-11-13T14:05:00.000Z", "playerLastUpdatedAt": "2026-11-13T14:05:00.000Z" } }, "monitoringStatus": { "origin": "user" }, "authType": "none", "sot": "player"}