List videos in your account
GET/api/v1/videos
List videos owned by your account (org), newest first. Paginate with the opaque cursor: pass the next_cursor from the previous response; a null next_cursor means the last page.
Scoped to your account only — the shared sample corpus is excluded. Optional filters: status, genre, iab_t1, garm_min_level, duration_min_sec, duration_max_sec, length_bucket, search, content_id, reindexed_since, reindex_run_id.
content_id matches your external content id from MRSS feed ingestion (exact match); an unknown id returns an empty list. Each item carries it back as external_content_id (null for videos not ingested from a feed).
reindexed_since (timestamp with a UTC offset, e.g. 2026-10-01T00:00:00Z; write + in an offset as %2B) returns videos whose most recent finished indexing attempt is a re-index that ended at or after that time, failed re-indexes included. It matches the item's indexed_at and index_trigger. Use it to catch up after missing notifications.
reindex_run_id (UUID) returns every video that has a job in that re-index run, including one still running. A video re-indexed again later in another run is still returned, while its own reindex_run_id field points to that later run.
Videos that were only indexed once match neither filter. A malformed UUID or a timestamp without a UTC offset returns 422.
Request
Responses
- 200
- 401
- 403
- 422
- 500
Successful Response
Missing or invalid API key. Add Authorization: Bearer vuf_live_<keyid>.<secret>.
Key used outside the public API roots (/api/v1, /api/v1.1).
Request body failed validation.
Upstream service error — usually safe to retry.