---
title: "Retrieve storyboard metadata in JSON format"
method: GET
path: "/{PLAYBACK_ID}/storyboard.json"
tags: ["Storyboards"]
---

# Retrieve storyboard metadata in JSON format

`GET /{PLAYBACK_ID}/storyboard.json`

Fetch metadata for the [storyboard image in JSON format](https://docs.mux.com/guides/create-timeline-hover-previews#json), detailing the coordinates and time ranges of each thumbnail.

## Path parameters

- `PLAYBACK_ID` string, required

## Query parameters

- `TOKEN` string
- `program_start_time` integer
- `program_end_time` integer
- `asset_start_time` number, float
- `asset_end_time` number, float
- `format` 'jpg' | 'png' | 'webp'

## Response `200`

JSON storyboard retrieved successfully.

- string

## 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)