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

## Changes

- **2025-07-24** `323c1dc63b7a` — 4 info
  - api tag `Thumbnails` added
  - api tag `Image` removed
  - added the new optional `query` request parameter `latest`
  - added the new optional `query` request parameter `program_time`
- **2025-07-02** `d4d7fca3b738` — 1 info
  - endpoint added

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