Skip to main content
GET
List videos
Returns the authenticated workspace’s owned video jobs in reverse chronological order. Use query parameters to narrow the response:
  • limit to cap the number of returned jobs
  • repeated status values to filter by lifecycle state
The response is a standard list envelope whose data array contains the same public video objects returned by POST /videos and GET /videos/{video_id}. This is useful for building:
  • async job dashboards
  • recent-generation history views
  • status-filtered polling views for completed, failed, or in-progress jobs

Authorizations

Authorization
string
header
required

Bearer token authentication

Query Parameters

limit
integer

Maximum number of video jobs to return. Defaults to 50 and caps at 200.

Required range: 1 <= x <= 200
status
string[]

Video lifecycle status filter. Repeat the parameter or provide comma-separated values.

Response

200 - application/json

Video list response

object
string
Example:

"list"

data
object[]
first_id
string | null
last_id
string | null
has_more
boolean
Last modified on July 26, 2026