---
title: "Video status and progress"
method: GET
path: "/videos/{id}"
tags: ["Videos"]
---

# Video status and progress

`GET /videos/{id}`

## Request

- Base URL: `https://app.makeaivideo.ai/api/v1`
- URL: `https://app.makeaivideo.ai/api/v1/videos/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Status

- object
  - `data` Video
    - `video_id` string
    - `title` string, nullable
    - `status` 'idea' | 'draft' | 'scripting' | 'generating' | 'scenes-ready' | 'composing' | 'ready' | 'failed': Terminal: ready, failed. A cancelled render ends as failed.
    - `progress` object
      - `note` string
      - `scenes_done` integer
      - `scenes_total` integer, nullable
    - `duration_seconds` integer, nullable
    - `aspect_ratio` string, nullable
    - `credits_used` integer, nullable
    - `error` string, nullable
    - `download` string, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `poll_after_seconds` integer, nullable: null when terminal
  - `error` unknown
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `404`: Unknown video

---

[API](https://skmtc.dev/makeaivideo/apis/makeaivideo-api.md) · [All operations](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/revisions/8c6351087d6d?raw)