---
title: "List video playlists"
method: GET
path: "/api/v1/video-playlists"
tags: ["Video Playlists"]
---

# List video playlists

`GET /api/v1/video-playlists`

## Query parameters

- `start` integer
- `count` integer
- `sort` string
- `playlistType` 1 | 2 — The video playlist type (Regular = `1`, Watch Later = `2`)

## Response `200`

successful operation

- object
  - `data` 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
  - `total` 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)