---
title: "Get a player"
method: GET
path: "/v2/sites/{site_id}/players/{player_id}/"
tags: ["players"]
---

# Get a player

`GET /v2/sites/{site_id}/players/{player_id}/`

## Request

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

Get a player

## Path parameters

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

## Response `200`

Resources successfully retrieved

- PlayerResourceRead
  - `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
    - `recommendations_playlist` RelationshipRead
      - `id` string: Unique identifier for a resource
      - `type` string: Resource type
    - `adschedule` RelationshipRead
      - `id` string: Unique identifier for a resource
      - `type` string: Resource type
  - `metadata` PlayerMetadata
    - `name` string: User-generated name used to uniquely identify a player A maximum of 10000 characters is permitted.
    - `setup_config` object: Set of [features, behaviors, and options](https://docs.jwplayer.com/jwplayer/docs/jw8-player-configuration-reference#setup-options) used to instantiate a player
    - `release_channel` 'latest' | 'biannual' | 'downgrade' | 'preview' | 'previous': Defines the [release channel](https://docs.jwplayer.com/jwplayer/docs/jw8-use-jw-player-release-channels) to which the player is set Release channels offer different speeds of automatically updating player versions. Default: `latest`
    - `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.
  - `version` '8': Major version associated with the player

## 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/players/:player_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)