> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musique.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Playlists

> Fetch curated playlists with CDN-served audio URLs for direct playback in your application.

<Badge color="yellow">Soon</Badge>

<Note>
  Playlist endpoints are under development and not yet available in production. Contact [support@musique.app](mailto:support@musique.app) to be notified when they launch.
</Note>

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:

| Field            | Description                                     |
| ---------------- | ----------------------------------------------- |
| `updatedAt`      | When playlist metadata (e.g. name) last changed |
| `songsUpdatedAt` | When 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

```json theme={null}
{
  "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

<CardGroup cols={2}>
  <Card title="List Playlists" icon="list-music" href="/api-reference/playlists/list-playlists">
    Retrieve all playlists assigned to your company.
  </Card>

  <Card title="Get Playlist" icon="music" href="/api-reference/playlists/get-playlist">
    Retrieve a single playlist with its full song list and audio URLs.
  </Card>
</CardGroup>