---
title: "Get a playlist"
method: GET
path: "/v2/sites/{site_id}/playlists/{playlist_id}/"
tags: ["playlists"]
---

# Get a playlist

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

## Request

- Base URL: `https://api.jwplayer.com`
- URL: `https://api.jwplayer.com/v2/sites/{site_id}/playlists/{playlist_id}/`
- Auth: API key in header `Authorization`

## Path parameters

- `site_id` string, required: Unique identifier for a resource
- `playlist_id` string, required: Unique identifier for a resource

## Response `200`

Resource successfully retrieved

- 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](doc:stream-faq-how-can-i-delete-a-custom-parameter). **NOTE**: To assign a content type to a media item, set the `contentType` custom parameter to the name of a content type configured for the property. When updating an existing media item, do not send `contentType` alone. Include all existing `custom_params` key-value pairs in the PATCH request; any omitted pairs are deleted.
  - `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](doc: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

- `404`: Resource with ID supplied does not exist in account and object namespace

## Changes

- **2026-11-03** `9fad6bd5872e`: 1 info
  - added the media type `application/json` for the response with the status `404`

[Operation history](https://skmtc.dev/jwplayer/apis/management-api-v2/changes/v2/sites/:site_id/playlists/:playlist_id/get.md)

---

[API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jwplayer/apis/management-api-v2/revisions/9fad6bd5872e?raw)