---
title: "Retrieve a video thumbnail"
method: GET
path: "/{PLAYBACK_ID}/thumbnail.{EXTENSION}"
tags: ["Thumbnails"]
---

# Retrieve a video thumbnail

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

[Fetch a thumbnail image from a video](https://docs.mux.com/guides/get-images-from-a-video) at a specified time with optional transformations.

## Path parameters

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

## Query parameters

- `TOKEN` string
- `time` number, float
- `width` integer
- `height` integer
- `rotate` 90 | 180 | 270
- `fit_mode` 'preserve' | 'stretch' | 'crop' | 'smartcrop' | 'pad'
- `flip_v` boolean
- `flip_h` boolean
- `program_time` integer
- `latest` boolean

## Response `200`

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