Skip to content
Last.fm is disabling API Keys for non-paid accounts December 1st.Learn More

Get All Sources/Clients

GET
/api/components
curl --request GET \
--url https://example.com/api/components \
--cookie ms.session_token=<ms.session_token>

Success

Media typeapplication/json
Array
One of:
Source
object
id
required
integer
>= -9007199254740991 <= 9007199254740991
uid
required
string
mode
required
string
Allowed value: source
type
required
name
required
string
state
required

General state of the component like Idle, Stopped, Running, Error

number
Allowed values: 1 2 3 4 5 6 7
status

More specific, live activity state like “sleeping”, “hydrating historical scrobbles”, “processing dead scrobbles”, etc…

string
players
required
object
key
additional properties
object
platformId
required

Unique tuple identifying user and device

string
play

Full play/scrobble object information

object
id
integer
>= -9007199254740991 <= 9007199254740991
uid
string
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
meta
playDate

The date the track was played at

string format: date-time
playDateCompleted

When the track finished playing

string format: date-time
listenedFor

Number of seconds the track was listened to

number
listenRanges

Ranges of the track that were listened to

Array<object>
object
start
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
end
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required
object
source

Type of Source that discovered this play

string
sourceSOT
string
Allowed values: player history ingress
seenAt

When Multi-Scrobbler first saw this play

string format: date-time
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
parsedFrom

Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…

string
Allowed values: backlog now playing player history ingress
trackId

Unique ID for this track, given by the Source

string
playId

Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”

string
newFromSource
boolean
url
object
web

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

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
user
string
mediaType
string
server
string
library
string
trackProgressPosition

The position the “player” is at in the track at the time the play was reported, in seconds

number
mediaPlayerName

Name of the media player (program)

string
mediaPlayerVersion

Version of the media player (program)

string
deviceId

A unique identifier for the device playing this track

string
sessionId

The ID/Key for individual sessions on a device/platform

string
nowPlaying
boolean
scrobbleTsSOC
Any of:
number
Allowed value: 1
comment
string
wasMonitored

Was the component activitely monitoring when this Play was created?

boolean
lifecycleInputs
Array
original
object
data

Original data from the Source the play was created from

play

The play before any transforms were applied

object
id
integer
>= -9007199254740991 <= 9007199254740991
uid
string
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
meta
playDate

The date the track was played at

string format: date-time
playDateCompleted

When the track finished playing

string format: date-time
listenedFor

Number of seconds the track was listened to

number
listenRanges

Ranges of the track that were listened to

Array<object>
object
start
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
end
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required
object
source

Type of Source that discovered this play

string
sourceSOT
string
Allowed values: player history ingress
seenAt

When Multi-Scrobbler first saw this play

string format: date-time
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
parsedFrom

Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…

string
Allowed values: backlog now playing player history ingress
trackId

Unique ID for this track, given by the Source

string
playId

Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”

string
newFromSource
boolean
url
object
web

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

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
user
string
mediaType
string
server
string
library
string
trackProgressPosition

The position the “player” is at in the track at the time the play was reported, in seconds

number
mediaPlayerName

Name of the media player (program)

string
mediaPlayerVersion

Version of the media player (program)

string
deviceId

A unique identifier for the device playing this track

string
sessionId

The ID/Key for individual sessions on a device/platform

string
nowPlaying
boolean
scrobbleTsSOC
Any of:
number
Allowed value: 1
comment
string
wasMonitored

Was the component activitely monitoring when this Play was created?

boolean
lifecycleInputs
Array
scrobble

Scrobble action plus the match result before scrobbling

object
match

Outcome of matching this Play against existing scrobbles

object
match
required

Did the play matxh an existing play?

boolean
score
required

Confidence of match, out of ~100. 90+ is high confidence

number
breakdowns
required

Score calculation summaries for each Play part analyzed

Array<string>
reason

Why or why not the play matched

string
closestMatchedPlay
object
id
integer
>= -9007199254740991 <= 9007199254740991
uid
string
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
meta
playDate

The date the track was played at

string format: date-time
playDateCompleted

When the track finished playing

string format: date-time
listenedFor

Number of seconds the track was listened to

number
listenRanges

Ranges of the track that were listened to

Array<object>
object
start
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
end
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required
object
source

Type of Source that discovered this play

string
sourceSOT
string
Allowed values: player history ingress
seenAt

When Multi-Scrobbler first saw this play

string format: date-time
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
parsedFrom

Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…

string
Allowed values: backlog now playing player history ingress
trackId

Unique ID for this track, given by the Source

string
playId

Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”

string
newFromSource
boolean
url
object
web

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

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
user
string
mediaType
string
server
string
library
string
trackProgressPosition

The position the “player” is at in the track at the time the play was reported, in seconds

number
mediaPlayerName

Name of the media player (program)

string
mediaPlayerVersion

Version of the media player (program)

string
deviceId

A unique identifier for the device playing this track

string
sessionId

The ID/Key for individual sessions on a device/platform

string
nowPlaying
boolean
scrobbleTsSOC
Any of:
number
Allowed value: 1
comment
string
wasMonitored

Was the component activitely monitoring when this Play was created?

boolean
lifecycleInputs
Array
transformedPlay
object
id
integer
>= -9007199254740991 <= 9007199254740991
uid
string
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
meta
playDate

The date the track was played at

string format: date-time
playDateCompleted

When the track finished playing

string format: date-time
listenedFor

Number of seconds the track was listened to

number
listenRanges

Ranges of the track that were listened to

Array<object>
object
start
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
end
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required
object
source

Type of Source that discovered this play

string
sourceSOT
string
Allowed values: player history ingress
seenAt

When Multi-Scrobbler first saw this play

string format: date-time
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
parsedFrom

Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…

string
Allowed values: backlog now playing player history ingress
trackId

Unique ID for this track, given by the Source

string
playId

Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”

string
newFromSource
boolean
url
object
web

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

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
user
string
mediaType
string
server
string
library
string
trackProgressPosition

The position the “player” is at in the track at the time the play was reported, in seconds

number
mediaPlayerName

Name of the media player (program)

string
mediaPlayerVersion

Version of the media player (program)

string
deviceId

A unique identifier for the device playing this track

string
sessionId

The ID/Key for individual sessions on a device/platform

string
nowPlaying
boolean
scrobbleTsSOC
Any of:
number
Allowed value: 1
comment
string
wasMonitored

Was the component activitely monitoring when this Play was created?

boolean
lifecycleInputs
Array
summary
string
createdAt
required
string format: date-time
payload

Raw/json payload sent to the downstream scrobble service

warnings

Anomalies returned from the scrobble service, or detected by MS, that did not stop scrobbling but look suspicious

Array<string>
error
response

Raw/json response from the scrobble service

mergedScrobble

If service responded with data, the result of merging this corrected data into MS’s play

object
id
integer
>= -9007199254740991 <= 9007199254740991
uid
string
data
required
object
track
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
artists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
albumArtists
Array<object>
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
album
object
name
required
string
metadata
Array
One of:
MusicBrainz ID
object
name
required
string
Allowed value: musicbrainz
image
string
id
required
string
idType
string
Allowed values: recording release track artist release-group
image
string
duration

The length of the track, in seconds

number
meta
playDate

The date the track was played at

string format: date-time
playDateCompleted

When the track finished playing

string format: date-time
listenedFor

Number of seconds the track was listened to

number
listenRanges

Ranges of the track that were listened to

Array<object>
object
start
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
end
required
object
timestamp
required
string format: date-time
position

Position in the track, in seconds

number
positionPercent

Position in the track, as a percentage of duration

number
repeat

Play was detected as a repeat of the previous play

boolean
meta
required
object
source

Type of Source that discovered this play

string
sourceSOT
string
Allowed values: player history ingress
seenAt

When Multi-Scrobbler first saw this play

string format: date-time
musicService

If applicable, the name of the Service providing the track (Spotify, Tidal, etc…)

string
parsedFrom

Specifies from what facet/data from the source this play was parsed from IE player, backlog, now playing, etc…

string
Allowed values: backlog now playing player history ingress
trackId

Unique ID for this track, given by the Source

string
playId

Atomic ID for this instance of played tracked IE a unique ID for “this track played at this time”

string
newFromSource
boolean
url
object
web

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

string
origin

The URL where this play was originally played. IE Frank Sinatra - My way FROM youtube.com = URL pointing to specific video

string
user
string
mediaType
string
server
string
library
string
trackProgressPosition

The position the “player” is at in the track at the time the play was reported, in seconds

number
mediaPlayerName

Name of the media player (program)

string
mediaPlayerVersion

Version of the media player (program)

string
deviceId

A unique identifier for the device playing this track

string
sessionId

The ID/Key for individual sessions on a device/platform

string
nowPlaying
boolean
scrobbleTsSOC
Any of:
number
Allowed value: 1
comment
string
wasMonitored

Was the component activitely monitoring when this Play was created?

boolean
lifecycleInputs
Array
createdAt
string format: date-time
lifecycle
Array
playFirstSeenAt

ISO8601 timestamp

string format: date-time
playLastUpdatedAt

Last time play was updated in MS

string format: date-time
playerLastUpdatedAt
required

Last time player self-reported it was updated at

string format: date-time
createdAt

When this specific play/player was created

number
position

Player position, in seconds

number
listenedDuration
required

Seconds the current track has been listened to

number
nowPlayingMode

If player is mirroring generic now-playing (from upstream LZ/LFM client)

boolean
status
required

Status of player

object
reported
required

What player reported: paused, playing, stopped, unknown

string
calculated
required

What MS has derived from watching player behavior: paused, playing, stopped, unknown

string
stale
required

When player has not reported any new updates for N seconds

boolean
orphaned
required

When player has not reported any new updates for N * 2 seconds

boolean
errors
Array
warnings
Array
monitoringStatus
object
monitoring
required
boolean
origin
required
string
Allowed values: user system
deadLetterPlays
required
integer
>= -9007199254740991 <= 9007199254740991
deadLetterPlaysTotal
required
integer
>= -9007199254740991 <= 9007199254740991
queued
required
integer
>= -9007199254740991 <= 9007199254740991
countLive
required

Number of discovered/scrobbled plays found in real time

integer
>= -9007199254740991 <= 9007199254740991
countNonLive
required

Number of discovered/scrobbled plays from backlog/jobs

integer
>= -9007199254740991 <= 9007199254740991
listenedLive
required

Seconds of discovered plays (sources only)

integer
>= -9007199254740991 <= 9007199254740991
createdAt
string format: date-time
lastReadyAt
string format: date-time
lastActiveAt
string format: date-time
hasAuth
required
boolean
hasAuthInteraction
required
boolean
authed
required
boolean
authType
required
string
Allowed values: none interactive unattended
initialized
required
boolean
synced
boolean
syncedReason
string | null
syncError
Any of:
lastImport
string format: date-time
lastImportSuccess
string format: date-time
sot
required
string
Allowed values: player history ingress
supportsUpstreamRecentlyPlayed
required
boolean
tracksDiscovered
required
integer
>= -9007199254740991 <= 9007199254740991
wakeAt
string format: date-time
sleeping
required
boolean

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"
}
]