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

# Show Customizations

`GET /medias/{mediaId}/customizations`

## Request

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

Fetches explicitly defined customizations 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
  - `playerColor` string: The color of the video player.
  - `stillUrl` string
  - `autoPlay` string: Whether the video should auto play or not.
  - `bpbTime` string
  - `controlsVisibleOnLoad` string
  - `endVideoBehavior` string: Behavior of the video at the end.
  - `fullscreenButton` string
  - `branding` string
  - `playbar` string
  - `playButton` string: Indicates if the play button is visible.
  - `settingsControl` string
  - `showCustomerLogo` string
  - `qualityControl` string
  - `playbackRateControl` string
  - `smallPlayButton` string
  - `spherical` string
  - `volumeControl` string
  - `copyLinkAndThumbnailEnabled` string
  - `doNotTrack` string
  - `email` string
  - `fitStrategy` string
  - `fullscreenOnRotateToLandscape` string
  - `muted` string
  - `playlistLinks` string
  - `playlistLoop` string
  - `playsinline` string
  - `playPauseNotifier` string
  - `playSuspendedOffScreen` string
  - `preload` string
  - `qualityMax` string
  - `qualityMin` string
  - `resumable` string
  - `seo` string
  - `silentAutoPlay` string
  - `time` string
  - `thumbnailAltText` string
  - `videoFoam` string
  - `volume` string
  - `wmode` string
  - `keyMoments` string: String representation of whether the key moments feature is enabled.
  - `plugin` object: Container for player plugin configurations. Plugin keys are extensible and not strictly validated; the documented sub-objects represent the most common plugins.
    - `passwordProtectedVideo` object
      - `on` string
      - `src` string
      - `challenge` string
      - `async` string
    - `videoThumbnail` object
      - `clickToPlayButton` string
    - `socialbar-v1` object
      - `buttons` string
      - `showTweetCount` string
      - `tweetText` string
      - `height` string
    - `chapters` object
      - `visibleOnLoad` string
      - `chapterList` object[]
        - `id` string
        - `title` string
        - `time` string
        - `deleted` string
      - `on` string
    - `postRoll-v1` object: Adds a Call To Action to your Video (response format)
      - `rewatch` string: String representation of whether the video can be rewatched.
      - `text` string: The URL of the text to be displayed.
      - `link` string: The URL of the link to be displayed.
      - `time` string: The time when the post-roll should be displayed as a string.
      - `autoSize` string: String representation of whether the post-roll will automatically adjust its size.
      - `style` object
        - `backgroundColor` string: The background color of the post-roll.
      - `ctaType` string: The type of call-to-action to be displayed.
      - `on` string: String representation of whether the post-roll is enabled.
      - `conversionOpportunityKey` string: The key used for tracking conversion opportunities.
    - `captions-v1` object: Captions plugin configuration (response format)
      - `on` string: String representation of whether the captions plugin is enabled ("true" or "false").
      - `onByDefault` string: String representation of whether captions are turned on by default ("true" or "false").
  - `private` object
    - `password_protect_on` string
    - `show_comments` string
  - `encrypted` object
    - `password_protect_password` 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/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)