---
title: "Retrieve a Wan video task"
method: GET
path: "/v1/videos/{task_id}"
---

# Retrieve a Wan video task

`GET /v1/videos/{task_id}`

Read the state of a Wan video task that was created through POST /v1/videos.

## Path parameters

- `task_id` string, required

## Response `200`

Current Wan video task state.

- WanVideoTask
  - `id` string, required — Task ID. Use this value as task_id in retrieve and content requests.
  - `task_id` string — Compatibility alias for id. The value matches id when present.
  - `object` string, required — Object type. Wan video tasks return video.
  - `model` string, required — Model ID used for the task.
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'error', required — Task lifecycle status. Poll until the value is completed, failed, or error.
  - `progress` integer, required — Task progress as a coarse percentage.
  - `created_at` integer, required — Task creation time as a Unix timestamp in seconds.
  - `completed_at` integer — Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
  - `video_url` string — Temporary video delivery URL. This field appears on completed tasks.
  - `error` object — Failure details. This field appears when the task fails.

## Other responses

- `400` — The task ID does not match a task for the authenticated user.
- `401` — The API key is missing or invalid.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)