List video tasks

GET/v1/video/tasks

Lists tasks submitted through the API, paginated (tasks submitted from the console Studio are excluded). Each element is a task object with the same shape as Get video task. Wan / HappyHorse have no list endpoint.

List video tasks

curl "https://api.hop-base.com/v1/video/tasks?page=1&limit=20" \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "tasks": [
    {
      "id": "vtEXAMPLE",
      "model": "dreamina-seedance-2-5-260628",
      "status": "completed",
      "outputs": [
        "https://api.hop-base.com/example-signed-video.mp4"
      ],
      "created_at": "2026-09-23T08:00:00Z",
      "completed_at": "2026-09-23T08:03:10Z"
    }
  ],
  "total": 1,
  "totalPages": 1
}

Headers

Authorization:requiredstring

Bearer sk-…: an API key created in the console under API keys; its group must include the requested model

Query parameters

page:optionalinteger

Page number, starting from 1

Range≥ 1Default1

limit:optionalinteger

Items per page

Range1–100Default20

Returns

200Task list

tasks:optionalarray of object

Task object

total:optionalinteger

Total number of tasks

totalPages:optionalinteger

Total number of pages

Errors

401Missing, invalid or expired API key (missing_api_key / invalid_api_key / api_key_expired)

Headers

Query parameters

Returns

Errors

Related