Skip to main content
GET
/
api
/
v1
/
tasks
List Tasks
curl --request GET \
  --url https://api.modelhunter.ai/api/v1/tasks \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}

​
Query Parameters

​
status
string
Filter by task status. One of: pending, queued, running, succeeded, failed, cancelled, expired.
​
provider
string
Filter by provider. Options: vidu, kling, seedream, seedance, gemini.
​
modelId
string
Filter by model ID (e.g., viduq3-turbo, kling-v3).
​
startDate
string
Filter tasks created after this date (ISO 8601 format).
​
endDate
string
Filter tasks created before this date (ISO 8601 format).
​
search
string
Search by task ID prefix.
​
limit
number
default:20
Items per page. Range: 1–100.
​
cursor
string
Cursor for pagination. Pass the cursor value from a previous response to get the next page.
{
  "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
  }
}