---
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}`

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.

---

[API](https://skmtc.net/muxinc/apis/mux-api.md) · [All operations](https://skmtc.net/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)