Get a Runway task

GET

runwayml

tasks

{id}

cURL

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  --header "Authorization: Bearer $COMETAPI_KEY"

import os
import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/runwayml/v1/tasks/{task_id}",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";

const response = await fetch(
  `https://api.cometapi.com/runwayml/v1/tasks/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000001"
}

Use this endpoint with the id returned by any /runwayml/v1 creation request. Authenticate with a CometAPI API key from the same account that created the task.

Follow the task state

The response is a task object. Read id, status, and output directly from the response, without a data envelope.

`status`	Next step
Missing, `PENDING`, or `THROTTLED`	Wait a few seconds and request the task again.
`RUNNING`	Continue polling. `progress`, when present, is a fraction from 0 to 1.
`SUCCEEDED`	Read result URLs from `output`.
`FAILED`	Stop polling and inspect `failure` and `failureCode`, when present.
`CANCELLED`	Stop polling; the task was cancelled.

A freshly submitted task can briefly return HTTP 400 with code: "task_not_exist". Wait a few seconds and retry using the same id. If it continues, check the task ID and the account used for authentication. Do not submit the creation request again to check its status.

Store the output

The output array contains image, video, or audio URLs according to the creation endpoint and selected format. Download completed assets promptly and store them in your own storage. The result URLs are temporary. For a new integration, choose a model and creation endpoint in the Runway overview.

Authorizations

Authorization

string

header

required

Use your CometAPI API key.

Path Parameters

string

required

Task ID returned by a /runwayml/v1 creation request.

Response

Task details. Fields vary with the task state.

string

required

Task ID returned by a Runway task-creation request.

status

enum<string>

Task state, when available. Poll until SUCCEEDED, FAILED, or CANCELLED.

Available options:

PENDING,

THROTTLED,

RUNNING,

SUCCEEDED,

FAILED,

CANCELLED

createdAt

string<date-time>

Task submission timestamp, when available.

progress

number

Fraction completed, when reported for a running task.

Required range: 0 <= x <= 1

output

string<uri>[]

Result URLs for a succeeded task. Download the assets promptly for storage.

failure

string

Failure explanation, when present on a failed task.

failureCode

string

Machine-readable failure code, when present.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Last modified on September 18, 2026

cURL

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  --header "Authorization: Bearer $COMETAPI_KEY"

import os
import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/runwayml/v1/tasks/{task_id}",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";

const response = await fetch(
  `https://api.cometapi.com/runwayml/v1/tasks/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000001"
}

Content moderation

API keys

Follow the task state

Store the output

Authorizations

Path Parameters

Response

​Follow the task state

​Store the output

Authorizations

Path Parameters

Response

Follow the task state

Store the output