---
title: "Retrieve a storyboard image for timeline hover previews"
method: GET
path: "/{PLAYBACK_ID}/storyboard.{EXTENSION}"
tags: ["Storyboards"]
---

# Retrieve a storyboard image for timeline hover previews

`GET /{PLAYBACK_ID}/storyboard.{EXTENSION}`

## Request

- Base URL: `https://image.mux.com`
- URL: `https://image.mux.com/{PLAYBACK_ID}/storyboard.{EXTENSION}`
- Auth: none declared

Fetch a storyboard image composed of multiple thumbnails for use in [timeline hover previews](https://docs.mux.com/guides/create-timeline-hover-previews).

## Path parameters

- `PLAYBACK_ID` string, required
- `EXTENSION` 'jpg' | 'png' | 'webp', required

## Query parameters

- `token` string
- `program_start_time` integer
- `program_end_time` integer
- `asset_start_time` number, float
- `asset_end_time` number, float

## Response `200`

Storyboard image retrieved successfully.

## Other responses

- `400`: Bad request due to invalid parameters.
- `404`: Video asset not found.

## Changes

- **2026-08-14** `92aac9f20a74`: 1 warning, 1 info
  - deleted the `query` request parameter `TOKEN`
  - added the new optional `query` request parameter `token`
- **2026-08-12** `5b4b3133f27d`: 2 breaking, 6 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `404`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - …4 more
- **2025-07-24** `323c1dc63b7a`: 6 info
  - api tag `Storyboards` added
  - api tag `Image` removed
  - added the new optional `query` request parameter `asset_end_time`
  - added the new optional `query` request parameter `asset_start_time`
  - …2 more
- **2025-07-02** `d4d7fca3b738`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/:PLAYBACK_ID/storyboard.:EXTENSION/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)