---
title: "GET /video/status"
method: GET
path: "/video/status"
---

# GET /video/status

`GET /video/status`

Unified video status endpoint that works across all video backends. Check the status of a video generation request using only the request ID and receive normalized status information.

## Query parameters

- `requestId` string, required

## Response `200`

Unified video generation status

- UnifiedVideoStatusResponse
  - `requestId` string, required — The unique request ID for the video generation
  - `status` 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'unknown', required — Current normalized status of the video generation
  - `progress` number, nullable — Generation progress as a percentage (0-100), if available
  - `estimatedTimeRemaining` number, nullable — Estimated time remaining in seconds, if available
  - `videoUrl` string, nullable, required — URL to the generated video (available when status is 'completed')
  - `error` string, nullable, required — Error message if the generation failed
  - `createdAt` string, nullable, required — ISO timestamp when the request was created
  - `completedAt` string, nullable, required — ISO timestamp when the generation completed

## Other responses

- `400` — Bad Request - Missing requestId parameter
- `404` — Video generation request not found
- `500` — Server Error - Failed to check video generation status

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) · [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nano-gpt/nanogpt-api/revisions/584e96d146b0/schema)