User's locker

get

https://api.7digital.com/1.2/user/locker

The locker allows you to manage an individual user's purchased tracks and releases.Get a paged list of releases and tracks for a user's locker (collection of all purchased tracks).

OAuth User token

Query Params

userId

int32

required

The unique identifier of the user. For information on creating users click here.

pagesize

int32

Sets the number of releases that will be returned per page. The default is 10, the maximum is 50.

page

int32

Sets the page to be returned in a paged list of the customers releases and tracks; by default this is the first page (page=1).

country

string

required

ISO 2-character country code which the end user resides in.

releaseId

int32

The MassiveMusic ID of the release you wish to filter down to, a specific release from the user's locker should be returned. Will return an empty locker response if no match is found on the releaseId.

trackId

int32

If supplied together with the releaseId, will returned only that specific track (provided it exists in user locker). Will return an empty locker response if no match is found.

purchaseId

int32

If supplied will return only the releases and tracks for that basket indicated by the purchaseId. Will return an error if no tracks are found.

sort

string

Orders the returned results. Supplied as a string in the format: "{sortColumn} {sortOrder}", for example: "purchaseDate desc" will show recent purchases first. Currently you can sort by releaseTitle (asc or desc), purchaseDate (asc or desc) or artistName (asc or desc). Defaults to "releaseTitle asc".

Language

Loading…