List videos

Usable endpoint to retrieve all of the videos' information, with filtering and sorting.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
GET https://apis.elai.io/api/v1/videos?status=ready,rendering&tags=template&sort=-updatedAt,name&limit=10
GET https://apis.elai.io/api/v1/videos?status=ready&status=rendering&tags=template&tags=mylist&sort=-updatedAt,+name&limit=10
Query Params
status
array of strings

Filter by video status. Repeat the parameter to match several. Six values exist (models/videos.ts): draft, validating, rendering, moderation, error, ready. validating and moderation were previously undocumented — a poll for "everything not finished yet" that lists only the other four silently loses videos in those two states.

status
Allowed:
tags
array of strings

Filter by linked tags

tags
string
enum

If empty, fetch only regular videos. template is the only supported value and fetches templates of all types. Any other value is ignored: the response is the regular video list, with a 200 and no indication that the filter did nothing.

Allowed:
sort
array of strings

Sorting by fields: -field — descending order, +field — ascending order (name, createdAt, updatedAt supported)

sort
int32
Defaults to 1

Selection page

int32
Defaults to 50

Selection limit. 100 records max.

boolean

If skipped (undefined) you'll recieve a full list of videos (Deleted and not deleted)

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json