---
title: "List Videos"
method: GET
path: "/v3/videos"
tags: ["Videos"]
---

# List Videos

`GET /v3/videos`

## Request

- Base URL: `https://api.edenai.run`
- URL: `https://api.edenai.run/v3/videos`
- Auth: HTTP bearer

List your video generation jobs, newest first.

## Query parameters

- `limit` integer: Number of jobs to return (1-100).
- `after` string, nullable: Cursor: return jobs created before this video id (use the previous page's `last_id`).

## Response `200`

Successful Response

- VideoListResponse: A page of the caller's video jobs, newest first.
  - `object` 'list'
  - `data` VideoObject[], required
    - `id` string, required: Job id. Use it to poll, download and delete.
    - `object` 'video'
    - `status` 'queued' | 'in_progress' | 'completed' | 'failed', required: queued, in_progress, completed or failed.
    - `progress` integer, nullable: 0 while running or failed, 100 when completed.
    - `created_at` integer, required: Unix timestamp (seconds) of job creation.
    - `completed_at` integer, nullable: Unix timestamp (seconds) when the job finished.
    - `expires_at` integer, nullable: Always null: Eden AI keeps the result.
    - `model` string, required: The `provider/model` that ran the job.
    - `seconds` string, nullable: Clip length in seconds, as a string.
    - `size` string, nullable: Requested resolution as `WIDTHxHEIGHT`.
    - `remixed_from_video_id` string, nullable: Always null: remix is not supported.
    - `error` VideoError: Why a video job failed.
      - `code` string, required: Machine-readable error code.
      - `message` string, required: Human-readable error message.
    - `provider` string, required: Eden extension: provider that ran the job.
    - `cost` number, required: Eden extension: cost in USD. 0 while the job is queued or in progress (the reserved estimate is not surfaced); the settled amount once the job completes or fails.
  - `first_id` string, nullable
  - `last_id` string, nullable
  - `has_more` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/edenai/apis/eden-ai-api-v3.md) - [All operations](https://skmtc.dev/edenai/apis/eden-ai-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/edenai/apis/eden-ai-api-v3/revisions/20ddfd49a3f4?raw)