> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelhunter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tasks

> List all generation tasks with filtering and cursor-based pagination.

## Query Parameters

<ParamField query="status" type="string">
  Filter by task status. One of: `pending`, `queued`, `running`, `succeeded`, `failed`, `cancelled`, `expired`.
</ParamField>

<ParamField query="provider" type="string">
  Filter by provider. Options: `vidu`, `kling`, `seedream`, `seedance`, `gemini`, `wan`.
</ParamField>

<ParamField query="modelId" type="string">
  Filter by model ID (e.g., `viduq3-turbo`, `kling-v3`).
</ParamField>

<ParamField query="startDate" type="string">
  Filter tasks created after this date (ISO 8601 format).
</ParamField>

<ParamField query="endDate" type="string">
  Filter tasks created before this date (ISO 8601 format).
</ParamField>

<ParamField query="search" type="string">
  Search by task ID prefix.
</ParamField>

<ParamField query="limit" type="number" default={20}>
  Items per page. Range: 1–100.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for pagination. Pass the `cursor` value from a previous response to get the next page.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "task_abc123",
        "type": "video",
        "status": "succeeded",
        "provider": "vidu",
        "model": "viduq3-turbo",
        "progress": 100,
        "cost": 0.32,
        "created_at": "2026-01-15T10:00:00Z",
        "started_at": "2026-01-15T10:00:02Z",
        "completed_at": "2026-01-15T10:00:32Z",
        "metadata": { "project": "demo" }
      },
      {
        "id": "task_def456",
        "type": "image",
        "status": "failed",
        "provider": "seedream",
        "model": "seedream-5-0-lite",
        "progress": 0,
        "error": {
          "code": "PROVIDER_ERROR",
          "message": "Content policy violation"
        },
        "created_at": "2026-01-15T09:50:00Z",
        "started_at": "2026-01-15T09:50:01Z",
        "completed_at": "2026-01-15T09:50:08Z"
      }
    ],
    "pagination": {
      "cursor": "2026-01-15T09:50:00Z",
      "hasMore": true,
      "total": 42
    }
  }
  ```
</ResponseExample>