## List videos

`$ openai videos list`

**get** `/videos`

List recently generated videos for the current project.

### Parameters

- `--after: optional string`

  Identifier for the last item from the previous pagination request

- `--limit: optional number`

  Number of items to retrieve

- `--order: optional "asc" or "desc"`

  Sort order of results by timestamp. Use `asc` for ascending order or `desc` for descending order.

### Returns

- `VideoListResource: object { data, first_id, has_more, 2 more }`

  - `data: array of Video`

    A list of items

    - `id: string`

      Unique identifier for the video job.

    - `completed_at: number`

      Unix timestamp (seconds) for when the job completed, if finished.

    - `created_at: number`

      Unix timestamp (seconds) for when the job was created.

    - `error: object { code, message }`

      Error payload that explains why generation failed, if applicable.

      - `code: string`

        A machine-readable error code that was returned.

      - `message: string`

        A human-readable description of the error that was returned.

    - `expires_at: number`

      Unix timestamp (seconds) for when the downloadable assets expire, if set.

    - `model: string or "sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more`

      The video generation model that produced the job.

      - `"sora-2"`

      - `"sora-2-pro"`

      - `"sora-2-2025-10-06"`

      - `"sora-2-pro-2025-10-06"`

      - `"sora-2-2025-12-08"`

    - `object: "video"`

      The object type, which is always `video`.

    - `progress: number`

      Approximate completion percentage for the generation task.

    - `prompt: string`

      The prompt that was used to generate the video.

    - `remixed_from_video_id: string`

      Identifier of the source video if this video is a remix.

    - `seconds: string or VideoSeconds`

      Duration of the generated clip in seconds. For extensions, this is the stitched total duration.

      - `"4"`

      - `"8"`

      - `"12"`

    - `size: "720x1280" or "1280x720" or "1024x1792" or "1792x1024"`

      The resolution of the generated video.

      - `"720x1280"`

      - `"1280x720"`

      - `"1024x1792"`

      - `"1792x1024"`

    - `status: "queued" or "in_progress" or "completed" or "failed"`

      Current lifecycle status of the video job.

      - `"queued"`

      - `"in_progress"`

      - `"completed"`

      - `"failed"`

  - `first_id: string`

    The ID of the first item in the list.

  - `has_more: boolean`

    Whether there are more items available.

  - `last_id: string`

    The ID of the last item in the list.

  - `object: "list"`

    The type of object returned, must be `list`.

### Example

```cli
openai videos list \
  --api-key 'My API Key'
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "completed_at": 0,
      "created_at": 0,
      "error": {
        "code": "code",
        "message": "message"
      },
      "expires_at": 0,
      "model": "string",
      "object": "video",
      "progress": 0,
      "prompt": "prompt",
      "remixed_from_video_id": "remixed_from_video_id",
      "seconds": "string",
      "size": "720x1280",
      "status": "queued"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}
```