---
title: "Show Playback Customizations"
method: GET
path: "/medias/{mediaId}/customizations/playback"
tags: ["Customizations"]
---

# Show Playback Customizations

`GET /medias/{mediaId}/customizations/playback`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/medias/{mediaId}/customizations/playback`
- Auth: HTTP bearer

Fetches the explicitly-set playback customizations (autoplay, mute, controls
visibility, player control buttons, end behavior, looping, quality bounds, and
embed/runtime flags) for the video.

## Requires api token with one of the following permissions
```
Read all folder and media data
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization for this media can also be used; any permission granted on
the media allows reading its customizations.

## Path parameters

- `mediaId` string, required

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Successful response

- object: Explicitly-set playback customizations for the video. Values are returned as strings (e.g. "true", "12"); fields that have never been set are omitted.
  - `autoPlay` string
  - `silentAutoPlay` string
  - `muted` string
  - `volume` string
  - `controlsVisibleOnLoad` string
  - `playButton` string
  - `smallPlayButton` string
  - `playbar` string
  - `volumeControl` string
  - `fullscreenButton` string
  - `settingsControl` string
  - `playbackRateControl` string
  - `qualityControl` string
  - `qualityMin` string
  - `qualityMax` string
  - `videoQuality` string
  - `hls` string
  - `endVideoBehavior` string
  - `playsinline` string
  - `playlistLoop` string
  - `playlistLinks` string
  - `playPauseNotifier` string
  - `playSuspendedOffScreen` string
  - `resumable` string
  - `preload` string
  - `time` string
  - `keyMoments` string
  - `fullscreenOnRotateToLandscape` string
  - `fakeFullScreen` string
  - `videoFoam` union: Either a string (e.g. "true") when set as a boolean, or an object with string-valued min/max width/height when set as a responsive-size config.
    - string
    - object
      - `minWidth` string
      - `maxWidth` string
      - `minHeight` string
      - `maxHeight` string
  - `wmode` string
  - `bpbTime` string
  - `spherical` string
  - `clickForSound` union
    - string
    - object
      - `showText` string
  - `seo` string
  - `doNotTrack` string
  - `copyLinkAndThumbnailEnabled` string
  - `email` string
  - `googleAnalytics` string

## Other responses

- `401`: Unauthorized, invalid or missing token
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/medias/:mediaId/customizations/playback/get.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)