---
title: "Poll a Runway official-format task"
method: GET
path: "/runwayml/v1/tasks/{id}"
---

# Poll a Runway official-format task

`GET /runwayml/v1/tasks/{id}`

Use the task id returned by an official-format Runway create endpoint. Fresh task ids can briefly return `task_not_exist` before the system begins returning task state. Output URLs are time-limited; download promptly and mirror to your own storage.

## Path parameters

- `id` string, required

## Headers

- `X-Runway-Version` string

## Response `200`

Current task state.

- object
  - `id` string, required — Task ID.
  - `status` 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED', required — Task status.
  - `createdAt` string — Task creation timestamp.
  - `output` string[] — Output URLs returned after the task succeeds.
  - `failure` string — Failure reason returned after the task fails.
  - `failureCode` string — Failure code returned after the task fails.
  - `progress` number — Task progress.

---

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