---
title: "Retrieve a video generation job"
method: GET
path: "/videos/{video_id}"
tags: ["Videos"]
---

# Retrieve a video generation job

`GET /videos/{video_id}`

Retrieves a video generation job. The gateway keeps no job state, so
the request is forwarded to the provider that created the job; pass
`provider` when the job id alone is not enough to route it.

## Path parameters

- `video_id` string, required

## Query parameters

- `provider` 'ollama' | 'ollama_cloud' | 'groq' | 'llamacpp' | 'openai' | 'cloudflare' | 'cohere' | 'anthropic' | 'deepseek' | 'elevenlabs' | 'google' | 'mistral' | 'minimax' | 'moonshot' | 'nvidia' | 'zai'

## Response `200`

The video generation job.

- VideoJob — A video generation job. Returned by `POST /videos` and `GET /videos/{video_id}`.
  - `id` string, required — Identifier of the video generation job. Opaque to clients - it may encode the provider - and must be sent back verbatim to `GET /videos/{video_id}`.
  - `object` 'video', required — The object type, which is always `video`.
  - `model` string, required — The model used to generate the video.
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed', required — Current status of the job.
  - `progress` integer — Completion percentage of the render.
  - `created_at` integer, required — Unix timestamp (in seconds) of when the job was created.
  - `completed_at` integer, nullable — Unix timestamp (in seconds) of when the job finished, null while it is still running.
  - `seconds` string — Duration of the generated video in seconds, as a string.
  - `size` string — Resolution of the generated video as `widthxheight`.
  - `error` object, nullable — The error that caused the job to fail, null otherwise.
    - `code` string — Machine-readable error code.
    - `message` string — Human-readable error message.

## Other responses

- `400` — The selected provider does not implement the Videos API. The gateway returns this when a request is routed to a provider without video generation support.
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-09-22** `a137b0cca33b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inference-gateway/apis/inference-gateway-api/changes/videos/:video_id/get.md)

---

[API](https://skmtc.dev/inference-gateway/apis/inference-gateway-api.md) · [All operations](https://skmtc.dev/inference-gateway/apis/inference-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inference-gateway/apis/inference-gateway-api/revisions/1b23a23c6ece?raw)