---
title: "Retrieve a playback ID"
method: GET
path: "/video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}"
tags: ["Assets"]
---

# Retrieve a playback ID

`GET /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Retrieves information about the specified playback ID.

## Path parameters

- `ASSET_ID` string, required
- `PLAYBACK_ID` string, required

## Response `200`

OK

- GetAssetPlaybackIDResponse
  - `data` PlaybackID, required
    - `id` string, required: Unique identifier for the PlaybackID
    - `policy` 'public' | 'signed' | 'drm', required: * `public` playback IDs are accessible by constructing an HLS URL like `https://stream.mux.com/${PLAYBACK_ID}` * `signed` playback IDs should be used with tokens `https://stream.mux.com/${PLAYBACK_ID}?token={TOKEN}`. See [Secure video playback](https://docs.mux.com/guides/secure-video-playback) for details about creating tokens. * `drm` playback IDs are protected with DRM technologies. [See DRM documentation for more details](https://docs.mux.com/guides/protect-videos-with-drm).
    - `drm_configuration_id` string: The DRM configuration used by this playback ID. Must only be set when `policy` is set to `drm`.

## Changes

- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2024-06-17** `cc252d3a50f1`: 1 warning, 1 info
  - added the new `drm` enum value to the `data/policy` response property for the response status `200`
  - added the optional property `data/drm_configuration_id` to the response with the `200` status
- **2024-06-06** `dcdbbcabe09e`: 1 warning, 1 info
  - removed the optional property `data/drm_configuration_id` from the response with the `200` status
  - removed the `drm` enum value from the `data/policy` response property for the response status `200`
- **2024-06-06** `cc252d3a50f1`: 1 warning, 1 info
  - added the new `drm` enum value to the `data/policy` response property for the response status `200`
  - added the optional property `data/drm_configuration_id` to the response with the `200` status

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/video/v1/assets/:ASSET_ID/playback-ids/:PLAYBACK_ID/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)
