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

Update Play

PUT
/api/components/{id}/plays/{uid}/play
curl --request PUT \
--url https://example.com/api/components/example/plays/example/play \
--header 'Content-Type: application/json' \
--cookie ms.session_token=<ms.session_token> \
--data '{ "data": { "track": { "name": "example", "metadata": [ { "name": "musicbrainz", "image": "example", "id": "example", "idType": "recording" } ], "image": "example" }, "artists": [ { "name": "example", "metadata": [ { "name": "musicbrainz", "image": "example", "id": "example", "idType": "recording" } ], "image": "example" } ], "albumArtists": [ { "name": "example", "metadata": [ { "name": "musicbrainz", "image": "example", "id": "example", "idType": "recording" } ], "image": "example" } ], "album": { "name": "example", "metadata": [ { "name": "musicbrainz", "image": "example", "id": "example", "idType": "recording" } ], "image": "example" }, "duration": 1, "isrc": "example", "meta": { "brainz": { "trackNumber": 1 } }, "playDate": "example", "listenedFor": 1 }, "meta": { "source": "example", "musicService": "example", "trackId": "example", "parsedFrom": "backlog", "url": { "web": "example", "origin": "example" } } }'
id
required
string
uid
required
string
Media typeapplication/json
object
data
required
object
track
required
object
name
required
string
>= 1 characters
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
required
Array<object>
>= 1 items
object
name
required
string
>= 1 characters
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
>= 1 characters
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
number
isrc
string
meta
object
brainz
object
trackNumber
integer
> 0 <= 9007199254740991
playDate
string
listenedFor
number
meta
required
object
source
string
musicService
string
trackId
string
parsedFrom
string
Allowed values: backlog now playing player history ingress
url
object
web
string
origin
string
key
additional properties
key
additional properties

Success

Media typeapplication/json
object
uid
required

Unique id for a Play

string
componentId
required
Any of:
integer
>= -9007199254740991 <= 9007199254740991
state
required
string
Allowed values: queued discarded failed duped scrobbled discovered
play
required
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
key
additional properties
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
key
additional properties
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
key
additional properties
original
object
data

Original data from the Source the play was created from

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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
key
additional properties
scrobble
object
match
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
summary
string
createdAt
required
string format: date-time
key
additional properties
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
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
createdAt
string format: date-time
key
additional properties
lifecycle
Array
key
additional properties
compacted
required

Dash-joined list of Play properties removed by retention compaction, IE ‘input-transform’

string | null
playedAt
required
Any of:
string format: date-time
seenAt
required
Any of:
string format: date-time
updatedAt
required
string format: date-time
error
required
Any of:
input
object
id
required
integer
>= -9007199254740991 <= 9007199254740991
data
required
Any of:

Raw data the Play was built from

play
required

The original 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
key
additional properties
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
key
additional properties
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
key
additional properties
original
object
data

Original data from the Source the play was created from

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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
key
additional properties
scrobble
object
match
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
summary
string
createdAt
required
string format: date-time
key
additional properties
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
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
key
additional properties
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
key
additional properties
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
key
additional properties
key
additional properties
createdAt
string format: date-time
key
additional properties
lifecycle
Array
key
additional properties
createdAt
required
Any of:
string format: date-time
queueStates
required
Array<object>
object
id
required
integer
>= -9007199254740991 <= 9007199254740991
queueName
required
string
queueStatus
required
string
Allowed values: completed failed queued
retries
required
integer
>= -9007199254740991 <= 9007199254740991
error
required
Any of:
updatedAt
required
string format: date-time
createdAt
required
string format: date-time
context
required
Any of:
Queue Context
object
transform
boolean
dupeCheck
boolean
useCache
boolean
reason
string
isRetry
boolean
key
additional properties
events
Array
One of:
Transform Event
object
id
integer
>= -9007199254740991 <= 9007199254740991
playId
required
integer
>= -9007199254740991 <= 9007199254740991
error
createdAt
string format: date-time
eventName
required
string
Allowed value: transform
data
required
Array

Example

{
"state": "queued",
"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
}
}
}
},
"input": {
"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
}
}
}
}
},
"queueStates": [
{
"queueStatus": "completed"
}
],
"events": [
{
"eventName": "transform"
}
]
}

The request failed validation

Media typeapplication/json

The request’s body, query or params didn’t match the route’s schema

object
error
required
string
Allowed value: Validation failed
details
required

What was wrong, one entry per problem

Array<object>
object
message
required
string
path

Where the problem is, e.g. [“amount”] or [“items”, 0, “id”]

Array

Example

{
"error": "Validation failed"
}