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

# List Playlists

> Retrieve all playlists assigned to your company.

<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 all playlists assigned to your company. Each item includes playlist metadata and timestamps. Songs are not included in the list view — use [Get Playlist](/api-reference/playlists/get-playlist) to retrieve the full song list for a specific playlist.

## Request

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

## Response

```json theme={null}
[
  {
    "playlistId": 1,
    "playlistName": "Summer Campaign",
    "updatedAt": "2026-06-30T09:00:00Z",
    "songsUpdatedAt": "2026-06-30T09:15:00Z"
  },
  {
    "playlistId": 2,
    "playlistName": "Weekend Vibes",
    "updatedAt": "2026-06-28T14:00:00Z",
    "songsUpdatedAt": "2026-06-29T10:30:00Z"
  }
]
```

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

## Error Responses

| Status | Code             | Description                           |
| ------ | ---------------- | ------------------------------------- |
| `401`  | `invalid_token`  | Token is missing, invalid, or revoked |
| `500`  | `internal_error` | Unexpected server error               |