---
title: "Get an animation"
method: GET
path: "/animations/{uid}"
---

# Get an animation

`GET /animations/{uid}`

## Path parameters

- `uid` string, required

## Response `200`

Animation details + live progress

- object
  - `uid` string
  - `status` 'queued' | 'completed' | 'failed' | 'rendering' — queued → rendering → completed / failed
  - `template` string — Source animation template UID
  - `files` object — Output file URL keyed by format (`mp4`, or `mov` when transparent)
  - `progress` integer — 0-100 render progress, 100 once completed
  - `metadata` string, nullable
  - `error` string, nullable — Error message (only present on failure)
  - `self` string, uri
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable

## Other responses

- `404` — Animation not found in this workspace

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) · [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bannerbear/bannerbear-v5-api/revisions/6aa425420a10/schema)