---
title: "Retrieve a player"
method: GET
path: "/players/{playerId}"
tags: ["Player Themes"]
---

# Retrieve a player

`GET /players/{playerId}`

Retreive a player theme by player id.

## Path parameters

- `playerId` string, required

## Response `200`

Success

- PlayerTheme
  - `name` string — The name of the player theme
  - `text` string — RGBA color for timer text. Default: rgba(255, 255, 255, 1)
  - `link` string — RGBA color for all controls. Default: rgba(255, 255, 255, 1)
  - `linkHover` string — RGBA color for all controls when hovered. Default: rgba(255, 255, 255, 1)
  - `linkActive` string — RGBA color for the play button when hovered.
  - `trackPlayed` string — RGBA color playback bar: played content. Default: rgba(88, 131, 255, .95)
  - `trackUnplayed` string — RGBA color playback bar: downloaded but unplayed (buffered) content. Default: rgba(255, 255, 255, .35)
  - `trackBackground` string — RGBA color playback bar: background. Default: rgba(255, 255, 255, .2)
  - `backgroundTop` string — RGBA color: top 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundBottom` string — RGBA color: bottom 50% of background. Default: rgba(0, 0, 0, .7)
  - `backgroundText` string — RGBA color for title text. Default: rgba(255, 255, 255, 1)
  - `enableApi` boolean — enable/disable player SDK access. Default: true
  - `enableControls` boolean — enable/disable player controls. Default: true
  - `forceAutoplay` boolean — enable/disable player autoplay. Default: false
  - `hideTitle` boolean — enable/disable title. Default: false
  - `forceLoop` boolean — enable/disable looping. Default: false
  - `playerId` string, required
  - `createdAt` string, date-time — When the player was created, presented in ATOM UTC format.
  - `updatedAt` string, date-time — When the player was last updated, presented in ATOM UTC format.
  - `assets` PlayerThemeAssets
    - `logo` string — The name of the file containing the logo you want to use.
    - `link` string — The path to the file containing your logo.

## Other responses

- `404` — Not Found
- `429` — Too Many Requests

## Changes

> 50 revisions in range; 1 not diffed.

- **2024-04-16** `ec2b79bfdc8d` — 1 info
  - added the non-success response with the status `429`
- **2022-04-28** `f9532dd3578c` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2022-02-07** `2a4d90a64f88` — 6 warning, 3 info
  - the optional response header `X-RateLimit-Limit` removed for the status `200`
  - the optional response header `X-RateLimit-Limit` removed for the status `404`
  - the optional response header `X-RateLimit-Remaining` removed for the status `200`
  - the optional response header `X-RateLimit-Remaining` removed for the status `404`
  - …5 more

[Change history](https://skmtc.dev/apivideo/apis/api-video/changes/players/:playerId/get.md)

---

[API](https://skmtc.dev/apivideo/apis/api-video.md) · [All operations](https://skmtc.dev/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)