---
title: "List recent tasks"
method: GET
path: "/api/v1/tasks"
tags: ["Tasks"]
---

# List recent tasks

`GET /api/v1/tasks`

## Request

- Base URL: `https://www.seedance2ai.io`
- URL: `https://www.seedance2ai.io/api/v1/tasks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/docs/api/v1/tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

List the tasks the key owner created through the API in the last 30 days, newest first. Each item has the same shape as GET /api/v1/tasks/{id}.

## Query parameters

- `limit` integer
- `before` string

## Response `200`

A page of tasks.

- object
  - `data` Task[], required
    - `id` string, required
    - `type` 'video' | 'image', required
    - `status` 'processing' | 'completed' | 'failed' | 'unknown', required: Poll while processing. completed and failed are final.
    - `model` string, required
    - `quality_tier` string, nullable
    - `channel` string, nullable
    - `resolution` string, nullable
    - `credits_used` number, required
    - `credits_refunded` number, required
    - `pricing` object, nullable: Frozen pricing contract (Seedance 2.5 and Kling 4.0 tasks).
    - `output` unknown, required
    - `result_urls` string[], required: Every result file URL, flattened.
    - `error` string, nullable, required: Why the task failed, worded for API callers.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: invalid_request: bad JSON, an unsupported field, or a value outside the documented constraints. The message names the first failing field and details lists them all. Fix the request; retrying it unchanged fails again.
- `401`: unauthorized: the API key is missing, invalid, or revoked.
- `429`: rate_limited: submissions are limited to 30 per 60 seconds and reads to 120 per 60 seconds per account; Seedance requests that inspect reference media have a lower limit. Wait for Retry-After before retrying.
- `500`: internal_error: an unexpected server failure. Retry with the same Idempotency-Key; contact support if it persists.

---

[API](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api.md) - [All operations](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seedance2ai/apis/seedance-2-0-ai-public-api/revisions/e4ef5c6db219?raw)