---
title: "Show playlist details."
method: GET
path: "/2/vod/playlists/{playlist}"
tags: ["V3 > Playlist"]
---

# Show playlist details.

`GET /2/vod/playlists/{playlist}`

Retrieves details of a specified playlist.

## Path parameters

- `playlist` string, required

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 1527df96Playlist
    - `name` string, required — The name of the Playlist
    - `description` string — The description of the Playlist
    - `type` object, required — Playlist type<note><strong>static</strong>: Allows only media to be added to the playlist</note><note><strong>dynamic</strong>: Add a folder to the playlist: all subsequent media added/removed will be synced to the playlist</note>
    - `mode` object, required — Playlist mode (changes progressbar behaviour)<note><strong>merge</strong>: The playlist playback will be uninterrupted: the media duration will be the sum of all playlist media</note><note><strong>split</strong>: Each media will be played individually: the progress-bar will be independent for each media</note><note><strong>live</strong>: The playlist will act as a live streaming: no scrubbing will be allowed</note>
    - `sort` object, required — Playlist order criterion<note><strong>auto</strong>: Sorted automatically</note><note><strong>created_asc</strong>: By creation date in ascending order</note><note><strong>created_desc</strong>: By creation date in descending order</note><note><strong>name_asc</strong>: By name in ascending order</note><note><strong>name_desc</strong>: By name in descending order</note><note><strong>duration_asc</strong>: By duration in ascending order</note><note><strong>duration_desc</strong>: By duration in descending order</note><note><strong>views_asc</strong>: By views in ascending order</note><note><strong>views_desc</strong>: By views in descending order</note><note><strong>random</strong>: Randomly sorted</note><note><strong>manual</strong>: Manually sorted</note>
    - `image` string — The playlist image link
    - `prepend` boolean, required — Prepend media instead of appending them
    - `auto_add_media_by_name` unknown[] — When a new media with name containing one of the configured values is uploaded, automatically add it to the playlist
      - unknown
    - `auto_add_media_by_description` unknown[] — When a new media with description containing one of the configured values is uploaded, automatically add it to the playlist
      - unknown
    - `show_media_thumbnail` boolean, required — Show media thumbnail
    - `show_media_info` boolean, required — Show media info
    - `nav_position` object, required — Playlist nav position<note><strong>above</strong>: Controls are placed above the playlist</note><note><strong>below</strong>: Controls are placed below the playlist</note>
    - `chapter_style` object, required — Playlist chapter style<note><strong>dark</strong>: Darker colors</note><note><strong>light</strong>: Lighter colors</note>
    - `show_controls` boolean, required — Indicates whether controls should be shown for the Playlist

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)