---
title: "Get the status of a motion graphics video"
method: GET
path: "/videos/{video_id}"
---

# Get the status of a motion graphics video

`GET /videos/{video_id}`

Retrieve the export status, details, and output URLs for a generated video job using its ID.

## Path parameters

- `video_id` string, required — The unique video/job ID returned when creating the job.

## Response `200`

Full export status and list of outputs for the specified video/job.

- GetVideoResponse — Complete status object and output info for a generated video job.
  - `video_id` string, required — Unique ID of this job/video.
  - `project_url` string — Optional user interface URL for this project.
  - `status` 'in-progress' | 'success' | 'failed', required — High-level status of the export job (in-progress, success, failed).
  - `outputs` ExportStatusEntry[], required — Detailed export output statuses for each configuration requested.
    - `status` 'in-progress' | 'success' | 'failed', required — Status of this export output (in-progress, success, or failed).
    - `file_url` string, nullable — URL to download or view the exported file if succeeded, or null if not applicable.
    - `config` object, required — Configuration details for this export output.
      - `format` 'mp4' | 'prores' | 'webm' | 'gif', required — Output format for this export (e.g. mp4, prores, webm, gif).
      - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:5', required — Aspect ratio for this export (e.g. '16:9', '9:16', '1:1', '4:5').
      - `fps` union, required — Frames per second for this export output.
        - '24'
        - '25'
        - '30'
        - '60'
      - `resolution` '360p' | '480p' | '720p' | '1080p' | '4k', required — Resolution for this export output (e.g. '1080p', '720p').
    - `error` string — Error message (if status is 'failed').

## Other responses

- `404` — No video/job found with the specified ID.

---

[API](https://skmtc.dev/hera/apis/hera-video-api.md) · [All operations](https://skmtc.dev/hera/apis/hera-video-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hera/hera-video-api/revisions/9c97fb6efc1d/schema)