---
title: "List playlists"
method: GET
path: "/v2/sites/{site_id}/playlists/"
tags: ["playlists"]
---

# List playlists

`GET /v2/sites/{site_id}/playlists/`

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Query parameters

- `page` integer
- `page_length` integer
- `q` string
- `sort` string

## Response `200`

Resources successfully retrieved

- PlaylistResourcesRead
  - `page` integer — Offset for returned resources
  - `page_length` integer — Maximum number of resources to return
  - `total` integer — Number of resources available before pagination
  - `playlists` PlaylistResourceRead[]
    - `schema` string
    - `id` string — Unique identifier for a resource
    - `created` string — Date and time at which the resource was created
    - `last_modified` string — Date and time at which the resource was most recently modified
    - `type` string — Name of the type of resource.
    - `relationships` object — Ancilliary resources associated to the primary resource being read
    - `metadata` PlaylistMetadata
      - `title` string — Title of the playlist. When using JWX's HTML5 player, the playlist title is displayed in the overlay. A maximum of 256 characters is permitted.
      - `description` string — Description of the playlist A maximum of 7500 characters is permitted.
      - `author` string — Author of the playlist A maximum of 256 characters is permitted.
      - `link` string — URL to be associated with the playlist A maximum of 2048 characters is permitted.
      - `custom_params` CustomParamSchema — User-generated key-value pairs When defining `custom_params`, include all custom parameters that should be associated with the target resource. When updating existing `custom_params`, include all `custom_params` keys with their updated values. Any `custom_params` key-value pair not included within the updated `custom_params` in the request body is [deleted](https://docs.jwplayer.com/platform/docs/stream-faq-how-can-i-delete-a-custom-parameter).
    - `playlist_type` 'article_matching' | 'dynamic' | 'manual' | 'search' | 'watchlist' — Type of playlist Possible values include: - `article_matching`: (Enterprise only) Insert contextually relevant videos into your articles. Filtering rules apply, including tag rules (inclusion and exclusion) and recency filtering. Article Matching playlists are limited to a **maximum of 100 videos**. Also read about how to [Embed videos with Article Matching](https://docs.jwplayer.com/platform/docs/jw8-embed-relevant-videos-with-article-matching). - `dynamic`: Automatically sort your videos using PATCH `/v2/playlists/{playlist_id}/dynamic_playlist` API call to specify what to sort by (publish date for example). Dynamic playlists are limited to a **maximum of 500 videos**. - `manual`: Manual channels are ordered by the user manually. Manage the playlist's content using POST and PATCH `/v2/playlists/{playlist_id}/manual_playlist` API calls. Manual playlists are limited to a **maximum of 10,000 videos**. - `recommendations`: (Enterprise only) Recommendation playlists return a set of recommended videos based on a source video. Recommendations playlists are limited to a **maximum of 100 videos**. - `search`: (Enterprise only) Search playlists contain videos ordered by similarity to a search term or phrase. Set the rules by which the playlist is filtered by using PATCH `/v2/playlists/{playlist_id}/search_playlist` API call. Search playlists are limited to a **maximum of 100 videos**. - `watchlist`: (Apps only) Watch list playlists return a set of videos based on viewer interactions within apps. For more information regarding Watch list playlists, please reach out to your JWX representative.
    - `default` boolean — (Recommendations) Indicates that the playlist is the default Recommendations playlist

## Other responses

- `400` — Bad Request The request either lacks certain attributes or contains malformed/invalid attributes.
- `404` — Not Found The requested asset could not be found.

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/versions/180db7cada27/schema)