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

# Retrieve a Seedance video task

`GET /v1/videos/{id}`

Read the latest state of a video task that was created through POST /v1/videos. Works for every Seedance model family. Poll every 10 to 20 seconds until status reaches a terminal value (`completed`, `failed`, or `error`). `video_url` is returned on `completed` responses.

## Path parameters

- `id` string, required

## Response `200`

Current Seedance video task state.

- VideoTask
  - `id` string, required — Task id.
  - `object` string, required — Object type, always `video`.
  - `model` string, required — Model id that generated the task.
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'error', required — Task status. `queued` and `in_progress` are non-terminal. `completed`, `failed`, and `error` are terminal.
  - `progress` integer, required — Completion percentage.
  - `video_url` string, nullable — Signed download URL for the finished video. Present on `completed` responses. Seedance downloads use this URL directly instead of a separate `/v1/videos/{id}/content` route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.
  - `created_at` integer, required — Task creation time as a Unix timestamp in seconds.
  - `completed_at` integer, nullable — Optional Unix timestamp returned by the platform. Use `status`, not this field, to decide when polling can stop.

## Other responses

- `400` — The id does not match any task.
- `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/revisions/0863102dbf34/schema)