---
title: "Check Video Status (Image-to-Video)"
method: GET
path: "/api/v1/videos/get"
tags: ["Videos"]
---

# Check Video Status (Image-to-Video)

`GET /api/v1/videos/get`

Poll this endpoint to check the status of an image-to-video generation job. Use the `id` returned from the video creation response. Recommended polling interval: every 5 seconds, with a maximum timeout of 5 minutes. Once status is `READY`, the `video_url` field contains a presigned download URL.

## Query parameters

- `videoId` string, required

## Response `200`

Video status retrieved

- object
  - `id` string — Video job ID
  - `status` 'GENERATING' | 'READY' | 'FAILED' — Current job status
  - `video_url` string, nullable — Presigned download URL. Only present when status is READY.

## Other responses

- `404` — Video not found

---

[API](https://skmtc.dev/oh/apis/ohapi-documentation.md) · [All operations](https://skmtc.dev/oh/apis/ohapi-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oh/ohapi-documentation/revisions/b623c2e9cb65/schema)
