---
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.

## Changes

- **2025-08-27** `4cb6473403b6` — 1 info
  - added the new optional `query` request parameter `format`
- **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

[Change history](https://skmtc.dev/muxinc/apis/mux-api/changes/:PLAYBACK_ID/storyboard.json/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-service-production.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)