---
title: "Get a video playlist"
method: GET
path: "/api/v1/video-playlists/{playlistId}"
tags: ["Video Playlists"]
---

# Get a video playlist

`GET /api/v1/video-playlists/{playlistId}`

## Path parameters

- `playlistId` integer, required

## Response `200`

successful operation

- VideoPlaylist
  - `createdAt` string, date-time
  - `description` string
  - `displayName` string
  - `id` integer
  - `isLocal` boolean
  - `ownerAccount` AccountSummary
    - `avatars` ActorImage[]
      - `createdAt` string, date-time
      - `path` string
      - `updatedAt` string, date-time
      - `width` integer
    - `displayName` string
    - `host` string, hostname
    - `id` integer
    - `name` string
    - `url` string, url
  - `privacy` VideoPlaylistPrivacyConstant
    - `id` 1 | 2 | 3 — Video playlist privacy policy (see [/video-playlists/privacies])
    - `label` string
  - `shortUUID` string — translation of a uuid v4 with a bigger alphabet to have a shorter uuid
  - `thumbnailPath` string
  - `type` VideoPlaylistTypeConstant
    - `id` 1 | 2 — The video playlist type (Regular = `1`, Watch Later = `2`)
    - `label` string
  - `updatedAt` string, date-time
  - `uuid` string, uuid
  - `videoChannel` VideoChannelSummary
    - `avatars` ActorImage[]
      - `createdAt` string, date-time
      - `path` string
      - `updatedAt` string, date-time
      - `width` integer
    - `displayName` string
    - `host` string, hostname
    - `id` integer
    - `name` string
    - `url` string, url
  - `videoLength` integer

---

[API](https://skmtc.net/cpy/apis/peertube.md) · [All operations](https://skmtc.net/cpy/apis/peertube/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpy/peertube/versions/efe11b159e43/schema)