Soon
This endpoint is under development and not yet available in production. Contact support@musique.app to be notified when it launches. 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
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 |
