Get Playlist - Musique App

Returns a single playlist including all assigned songs with CDN-served audio URLs ready for direct playback. Returns 403 if the playlist exists but does not belong to your company.

Request

GET /api/v1/integration/playlists/{id}
X-API-Key: msk_prod_1234567890abcdef
User-Agent: YourApp/1.0

Path Parameters

Parameter	Type	Description
`id`	integer	The playlist ID

Response

{
  "playlistId": 1,
  "playlistName": "Summer Campaign",
  "updatedAt": "2026-06-30T09:00:00Z",
  "songsUpdatedAt": "2026-06-30T09:15:00Z",
  "songs": [
    { "id": 1, "url": "https://cdn.musique.app/songs/track1.mp3" },
    { "id": 2, "url": "https://cdn.musique.app/songs/track2.mp3" }
  ]
}

Field	Type	Description
`playlistId`	integer	Unique identifier for the playlist
`playlistName`	string	Display name of the playlist
`updatedAt`	string (ISO 8601)	Last time playlist metadata (e.g. name) was updated
`songsUpdatedAt`	string (ISO 8601)	Last time songs were added or removed from the playlist
`songs`	array	All songs assigned to this playlist
`songs[].id`	integer	Unique identifier for the song
`songs[].url`	string	CDN URL for direct audio playback

Audio URLs point to cdn.musique.app for fast, globally-distributed delivery. Do not cache the raw URL structure — always use the URL returned in the response.

Error Responses

Status	Code	Description
`401`	`invalid_token`	Token is missing, invalid, or revoked
`403`	`insufficient_permissions`	Playlist exists but does not belong to your company
`404`	`playlist_not_found`	No playlist found with the given ID
`500`	`internal_error`	Unexpected server error