Fetch a user's full library playlists
GET/users/:id/library/playlists
Gets a user's saved/reposted/purchased/all playlists
Request
Path Parameters
id stringrequired
A user ID
Query Parameters
offset integer
The number of items to skip. Useful for pagination (page number * limit)
limit integer
The number of items to fetch
user_id string
The user ID of the user making the request
query string
The filter query
sort_direction string
Possible values: [asc, desc]
The sort direction
type string
Possible values: [all, repost, favorite, purchase]
Default value: favorite
The type of entity to return: favorited, reposted, purchased, or all. Defaults to favorite
sort_method string
Possible values: [added_date, reposts, saves]
The sort method
Header Parameters
Encoded-Data-Message string
The data that was signed by the user for signature recovery
Encoded-Data-Signature string
The signature of data, used for signature recovery
Responses
- 200
- 400
- 500
Success
- application/json
- Schema
- Example (from schema)
Schema
latest_chain_block integerrequired
latest_indexed_block integerrequired
latest_chain_slot_plays integerrequired
latest_indexed_slot_plays integerrequired
signature stringrequired
timestamp stringrequired
version
object
required
service stringrequired
version stringrequired
data object[]
{
"latest_chain_block": 0,
"latest_indexed_block": 0,
"latest_chain_slot_plays": 0,
"latest_indexed_slot_plays": 0,
"signature": "string",
"timestamp": "string",
"version": {
"service": "string",
"version": "string"
},
"data": [
{
"timestamp": "string",
"item_type": true,
"item": {
"artwork": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"description": "string",
"permalink": "string",
"id": "string",
"is_album": true,
"is_image_autogenerated": true,
"playlist_name": "string",
"playlist_contents": [
{
"metadata_timestamp": 0,
"timestamp": 0,
"track_id": "string"
}
],
"repost_count": 0,
"favorite_count": 0,
"total_play_count": 0,
"user": {
"album_count": 0,
"artist_pick_track_id": "string",
"artist_coin_badge": {
"mint": "string",
"logo_uri": "string",
"banner_image_url": "string",
"ticker": "string"
},
"coin_flair_mint": "string",
"bio": "string",
"cover_photo": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"followee_count": 0,
"follower_count": 0,
"handle": "string",
"id": "string",
"is_verified": true,
"twitter_handle": "string",
"instagram_handle": "string",
"tiktok_handle": "string",
"verified_with_twitter": true,
"verified_with_instagram": true,
"verified_with_tiktok": true,
"website": "string",
"donation": "string",
"location": "string",
"name": "string",
"playlist_count": 0,
"profile_picture": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"repost_count": 0,
"track_count": 0,
"is_deactivated": true,
"is_available": true,
"erc_wallet": "string",
"spl_wallet": "string",
"spl_usdc_wallet": "string",
"spl_usdc_payout_wallet": "string",
"supporter_count": 0,
"supporting_count": 0,
"total_audio_balance": 0,
"wallet": "string",
"balance": "string",
"associated_wallets_balance": "string",
"total_balance": "string",
"waudio_balance": "string",
"associated_sol_wallets_balance": "string",
"blocknumber": 0,
"created_at": "string",
"is_storage_v2": true,
"creator_node_endpoint": "string",
"current_user_followee_follow_count": 0,
"does_current_user_follow": true,
"does_current_user_subscribe": true,
"does_follow_current_user": true,
"handle_lc": "string",
"updated_at": "string",
"cover_photo_sizes": "string",
"cover_photo_cids": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"cover_photo_legacy": "string",
"profile_picture_sizes": "string",
"profile_picture_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"profile_picture_legacy": "string",
"has_collectibles": true,
"playlist_library": {
"contents": [
{}
]
},
"allow_ai_attribution": true,
"profile_type": "string"
},
"ddex_app": "string",
"access": {
"stream": true,
"download": true
},
"upc": "string",
"track_count": 0,
"blocknumber": 0,
"created_at": "string",
"followee_reposts": [
{
"repost_item_id": "string",
"repost_type": "string",
"user_id": "string"
}
],
"followee_favorites": [
{
"favorite_item_id": "string",
"favorite_type": "string",
"user_id": "string",
"created_at": "string"
}
],
"has_current_user_reposted": true,
"has_current_user_saved": true,
"is_delete": true,
"is_private": true,
"updated_at": "string",
"added_timestamps": [
{
"metadata_timestamp": 0,
"timestamp": 0,
"track_id": "string"
}
],
"user_id": "string",
"tracks": [
{
"artwork": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"description": "string",
"genre": "string",
"id": "string",
"track_cid": "string",
"preview_cid": "string",
"orig_file_cid": "string",
"orig_filename": "string",
"is_original_available": true,
"mood": "string",
"release_date": "2026-02-21",
"remix_of": {
"tracks": [
{
"parent_track_id": "string",
"user": {
"album_count": 0,
"artist_pick_track_id": "string",
"artist_coin_badge": {
"mint": "string",
"logo_uri": "string",
"banner_image_url": "string",
"ticker": "string"
},
"coin_flair_mint": "string",
"bio": "string",
"cover_photo": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"followee_count": 0,
"follower_count": 0,
"handle": "string",
"id": "string",
"is_verified": true,
"twitter_handle": "string",
"instagram_handle": "string",
"tiktok_handle": "string",
"verified_with_twitter": true,
"verified_with_instagram": true,
"verified_with_tiktok": true,
"website": "string",
"donation": "string",
"location": "string",
"name": "string",
"playlist_count": 0,
"profile_picture": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"repost_count": 0,
"track_count": 0,
"is_deactivated": true,
"is_available": true,
"erc_wallet": "string",
"spl_wallet": "string",
"spl_usdc_wallet": "string",
"spl_usdc_payout_wallet": "string",
"supporter_count": 0,
"supporting_count": 0,
"total_audio_balance": 0,
"wallet": "string",
"balance": "string",
"associated_wallets_balance": "string",
"total_balance": "string",
"waudio_balance": "string",
"associated_sol_wallets_balance": "string",
"blocknumber": 0,
"created_at": "string",
"is_storage_v2": true,
"creator_node_endpoint": "string",
"current_user_followee_follow_count": 0,
"does_current_user_follow": true,
"does_current_user_subscribe": true,
"does_follow_current_user": true,
"handle_lc": "string",
"updated_at": "string",
"cover_photo_sizes": "string",
"cover_photo_cids": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"cover_photo_legacy": "string",
"profile_picture_sizes": "string",
"profile_picture_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"profile_picture_legacy": "string",
"has_collectibles": true,
"playlist_library": {
"contents": [
{}
]
},
"allow_ai_attribution": true,
"profile_type": "string"
},
"has_remix_author_reposted": true,
"has_remix_author_saved": true
}
]
},
"repost_count": 0,
"favorite_count": 0,
"comment_count": 0,
"tags": "string",
"title": "string",
"user": {
"album_count": 0,
"artist_pick_track_id": "string",
"artist_coin_badge": {
"mint": "string",
"logo_uri": "string",
"banner_image_url": "string",
"ticker": "string"
},
"coin_flair_mint": "string",
"bio": "string",
"cover_photo": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"followee_count": 0,
"follower_count": 0,
"handle": "string",
"id": "string",
"is_verified": true,
"twitter_handle": "string",
"instagram_handle": "string",
"tiktok_handle": "string",
"verified_with_twitter": true,
"verified_with_instagram": true,
"verified_with_tiktok": true,
"website": "string",
"donation": "string",
"location": "string",
"name": "string",
"playlist_count": 0,
"profile_picture": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"repost_count": 0,
"track_count": 0,
"is_deactivated": true,
"is_available": true,
"erc_wallet": "string",
"spl_wallet": "string",
"spl_usdc_wallet": "string",
"spl_usdc_payout_wallet": "string",
"supporter_count": 0,
"supporting_count": 0,
"total_audio_balance": 0,
"wallet": "string",
"balance": "string",
"associated_wallets_balance": "string",
"total_balance": "string",
"waudio_balance": "string",
"associated_sol_wallets_balance": "string",
"blocknumber": 0,
"created_at": "string",
"is_storage_v2": true,
"creator_node_endpoint": "string",
"current_user_followee_follow_count": 0,
"does_current_user_follow": true,
"does_current_user_subscribe": true,
"does_follow_current_user": true,
"handle_lc": "string",
"updated_at": "string",
"cover_photo_sizes": "string",
"cover_photo_cids": {
"640x": "string",
"2000x": "string",
"mirrors": [
"string"
]
},
"cover_photo_legacy": "string",
"profile_picture_sizes": "string",
"profile_picture_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"profile_picture_legacy": "string",
"has_collectibles": true,
"playlist_library": {
"contents": [
{}
]
},
"allow_ai_attribution": true,
"profile_type": "string"
},
"duration": 0,
"is_downloadable": true,
"play_count": 0,
"permalink": "string",
"is_streamable": true,
"ddex_app": "string",
"playlists_containing_track": [
0
],
"pinned_comment_id": 0,
"album_backlink": {
"playlist_id": 0,
"playlist_name": "string",
"permalink": "string"
},
"access": {
"stream": true,
"download": true
},
"blocknumber": 0,
"create_date": "string",
"cover_art_sizes": "string",
"cover_art_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string"
},
"created_at": "string",
"credits_splits": "string",
"isrc": "string",
"license": "string",
"iswc": "string",
"field_visibility": {
"mood": true,
"tags": true,
"genre": true,
"share": true,
"play_count": true,
"remixes": true
},
"followee_reposts": [
{
"repost_item_id": "string",
"repost_type": "string",
"user_id": "string"
}
],
"has_current_user_reposted": true,
"is_scheduled_release": true,
"is_unlisted": true,
"has_current_user_saved": true,
"followee_favorites": [
{
"favorite_item_id": "string",
"favorite_type": "string",
"user_id": "string",
"created_at": "string"
}
],
"route_id": "string",
"stem_of": {
"category": "string",
"parent_track_id": 0
},
"track_segments": [
{
"duration": 0,
"multihash": "string"
}
],
"updated_at": "string",
"user_id": "string",
"is_delete": true,
"cover_art": "string",
"is_available": true,
"ai_attribution_user_id": 0,
"allowed_api_keys": [
"string"
],
"audio_upload_id": "string",
"preview_start_seconds": 0,
"bpm": 0,
"is_custom_bpm": true,
"musical_key": "string",
"is_custom_musical_key": true,
"audio_analysis_error_count": 0,
"comments_disabled": true,
"ddex_release_ids": {},
"artists": [
{}
],
"resource_contributors": [
{
"name": "string",
"roles": [
"string"
],
"sequence_number": 0
}
],
"indirect_resource_contributors": [
{
"name": "string",
"roles": [
"string"
],
"sequence_number": 0
}
],
"rights_controller": {
"name": "string",
"roles": [
"string"
],
"rights_share_unknown": "string"
},
"copyright_line": {
"year": "string",
"text": "string"
},
"producer_copyright_line": {
"year": "string",
"text": "string"
},
"parental_warning_type": "string",
"is_stream_gated": true,
"stream_conditions": {
"tip_user_id": 0
},
"is_download_gated": true,
"download_conditions": {
"tip_user_id": 0
},
"cover_original_song_title": "string",
"cover_original_artist": "string",
"is_owned_by_user": true,
"stream": {
"url": "string",
"mirrors": [
"string"
]
},
"download": {
"url": "string",
"mirrors": [
"string"
]
},
"preview": {
"url": "string",
"mirrors": [
"string"
]
}
}
],
"cover_art": "string",
"cover_art_sizes": "string",
"cover_art_cids": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string",
"mirrors": [
"string"
]
},
"is_stream_gated": true,
"stream_conditions": {
"tip_user_id": 0
},
"is_scheduled_release": true,
"release_date": "string",
"ddex_release_ids": {},
"artists": [
{}
],
"copyright_line": {},
"producer_copyright_line": {},
"parental_warning_type": "string"
},
"class": "string"
}
]
}
Bad request
Server error
Loading...