---
title: "Check Job Status"
method: GET
path: "/api/v1/jobs/{job_id}/status"
tags: ["Jobs"]
---

# Check Job Status

`GET /api/v1/jobs/{job_id}/status`

Poll this endpoint to check the status of an asynchronous job (image generation or text-to-video). Use the job_id received from the generation response. For image-to-video jobs, use GET /api/v1/videos/get instead. Recommended polling interval: every 2–5 seconds, with a maximum timeout of 5 minutes.

## Path parameters

- `job_id` string, required

## Response `200`

Job status retrieved successfully

- object
  - `job_id` string — The job identifier
  - `status` 'queued' | 'processing' | 'completed' | 'failed' — Current job status
  - `url` string, nullable — Presigned download URL for the generated content. Only present when status is "completed".
  - `results` object, nullable — Additional result data. May contain "image_prompt" (the enhanced prompt that was used) when prompt_enhancement was enabled.
    - `image_prompt` string — The enhanced prompt that was actually used for generation (only present if prompt_enhancement was enabled)
  - `error` string, nullable — Error message. Only present when status is "failed".

---

[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)
