Skip to main content
Soon
Playlist endpoints are under development and not yet available in production. Contact support@musique.app to be notified when they launch.
Playlists are curated collections of audio tracks assigned to your company by the Musique team. Your application fetches them via the partner API and plays the CDN-served audio URLs directly — no additional storage or processing required.

​
Core Concepts

​
How Playlists Work

Playlists are managed by Musique and assigned to your company. You fetch them read-only via the API. Each playlist contains songs with direct CDN URLs ready for playback.

​
Polling with Timestamps

Each playlist response includes two timestamps:
FieldDescription
updatedAtWhen playlist metadata (e.g. name) last changed
songsUpdatedAtWhen songs were last added or removed
Compare songsUpdatedAt against your cached value to decide whether a full re-fetch of songs is needed, avoiding unnecessary data transfer on every poll cycle.

​
Response Shape

{
  "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" }
  ]
}
Audio URLs point to cdn.musique.app for fast, globally-distributed delivery. Always use the URL returned in the response — do not construct URLs manually.

​
Endpoints

List Playlists

Retrieve all playlists assigned to your company.

Get Playlist

Retrieve a single playlist with its full song list and audio URLs.