---
title: "Get all playlists"
method: GET
path: "/streaming/playlists"
tags: ["Playlists"]
---

# Get all playlists

`GET /streaming/playlists`

Returns a list of created playlists

## Query parameters

- `page` integer

## Response `200`

Successful

- Playlist[]
  - `name` string — Playlist name
  - `client_id` integer — Current playlist client ID
  - `active` boolean — Enables/Disables playlist. Has two possible values: - true – Playlist can be played. - false – Playlist is disabled. No broadcast while it's desabled.
  - `start_time` string — Playlist start time. Playlist won't be available before the specified time. Datetime in ISO 8601 format.
  - `loop` boolean — Enables/Disables playlist loop
  - `video_ids` integer[] — A list of VOD IDs included in the playlist. Order of videos in a playlist reflects the order of IDs in the array. Maximum video limit = 128.
  - `client_user_id` integer — Custom field where you can specify user ID in your system
  - `ad_id` integer — The advertisement ID that will be inserted into the video
  - `player_id` integer — The player ID with which the video will be played
  - `countdown` boolean — Enables countdown before playlist start with ```playlist_type: live```
  - `playlist_type` 'live' | 'vod' — Determines whether the playlist: - `live` - playlist for live-streaming - `vod` - playlist is for video on demand access
  - `hls_url` string — A URL to a master playlist HLS (master.m3u8) with MPEG TS container. This URL is a link to the main manifest. But you can also manually specify suffix-options that will allow you to change the manifest to your request: ```/playlists/{client_id}_{playlist_id}/master[-cmaf][-min-N][-max-N][-img][-(h264|hevc|av1)].m3u8``` Please see the details in ```hls_url``` attribute of /videos/{id} method. Caution. Solely master.m3u8 (and master[-options].m3u8) is officially documented and intended for your use. Any additional internal manifests, sub-manifests, parameters, chunk names, file extensions, and related components are internal infrastructure entities. These may undergo modifications without prior notice, in any manner or form. It is strongly advised not to store them in your database or cache them on your end.
  - `hls_cmaf_url` string — A URL to a master playlist HLS (master-cmaf.m3u8) with CMAF-based chunks. Chunks are in fMP4 container. It is possible to use the same suffix-options as described in the "hls_url" attribute. Caution. Solely master.m3u8 (and master[-options].m3u8) is officially documented and intended for your use. Any additional internal manifests, sub-manifests, parameters, chunk names, file extensions, and related components are internal infrastructure entities. These may undergo modifications without prior notice, in any manner or form. It is strongly advised not to store them in your database or cache them on your end.
  - `iframe_url` string — A URL to a built-in HTML video player with the video inside. It can be inserted into an iframe on your website and the video will automatically play in all browsers. The player can be opened or shared via this direct link. Also the video player can be integrated into your web pages using the Iframe tag. Please see the details in ```iframe_url``` attribute of /videos/{id} method.

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)