---
title: "Retrieve an animated image from a video"
method: GET
path: "/{PLAYBACK_ID}/animated.{EXTENSION}"
tags: ["Animated Images"]
---

# Retrieve an animated image from a video

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

[Fetch an animated GIF or WebP image](https://docs.mux.com/guides/get-images-from-a-video#get-an-animated-gif-from-a-video) from a video segment with optional transformations.

## Path parameters

- `PLAYBACK_ID` string, required
- `EXTENSION` 'gif' | 'webp', required

## Query parameters

- `TOKEN` string
- `start` number, float
- `end` number, float
- `width` integer
- `height` integer
- `fps` integer

## Response `200`

Animated image retrieved successfully.

## Other responses

- `400` — Bad request due to invalid parameters.
- `404` — Video asset not found.

## Changes

- **2025-07-24** `323c1dc63b7a` — 2 info
  - api tag `Animated Images` added
  - api tag `Image` removed
- **2025-07-02** `d4d7fca3b738` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/muxinc/apis/mux-api/changes/:PLAYBACK_ID/animated.: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)