> ## 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.

# Get Playlist

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

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

<Note>
  This endpoint is under development and not yet available in production. Contact [support@musique.app](mailto:support@musique.app) to be notified when it launches.
</Note>

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

```http theme={null}
GET /api/v1/integration/playlists/{id}
X-API-Key: msk_prod_1234567890abcdef
```

### Path Parameters

| Parameter | Type    | Description     |
| --------- | ------- | --------------- |
| `id`      | integer | The playlist ID |

## Response

```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" }
  ]
}
```

| 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                       |

<Note>
  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.
</Note>

## 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                             |