List videos

VideoListPage videos().list(, )

GET/videos

List recently generated videos for the current project.

ParametersExpand Collapse

VideoListParams params

Optional<String> after

Identifier for the last item from the previous pagination request

Optional<Long> limit

Number of items to retrieve

minimum0

maximum100

Optional<Order> order

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

ASC("asc")

DESC("desc")

ReturnsExpand Collapse

class Video:

Structured information describing a generated video job.

String id

Unique identifier for the video job.

Optional<Long> completedAt

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

long createdAt

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

Optional<VideoCreateError> error

Error payload that explains why generation failed, if applicable.

String code

A machine-readable error code that was returned.

String message

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

Optional<Long> expiresAt

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

VideoModel model

The video generation model that produced the job.

Accepts one of the following:

SORA_2("sora-2")

SORA_2_PRO("sora-2-pro")

SORA_2_2025_10_06("sora-2-2025-10-06")

SORA_2_PRO_2025_10_06("sora-2-pro-2025-10-06")

SORA_2_2025_12_08("sora-2-2025-12-08")

JsonValue; object_

The object type, which is always video.

long progress

Approximate completion percentage for the generation task.

Optional<String> prompt

The prompt that was used to generate the video.

Optional<String> remixedFromVideoId

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

VideoSeconds seconds

Duration of the generated clip in seconds.

Accepts one of the following:

_4("4")

_8("8")

_12("12")

VideoSize size

The resolution of the generated video.

Accepts one of the following:

_720X1280("720x1280")

_1280X720("1280x720")

_1024X1792("1024x1792")

_1792X1024("1792x1024")

Status status

Current lifecycle status of the video job.

Accepts one of the following:

QUEUED("queued")

IN_PROGRESS("in_progress")

COMPLETED("completed")

FAILED("failed")

List videos

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.videos.VideoListPage;
import com.openai.models.videos.VideoListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        VideoListPage page = client.videos().list();
    }
}

{
  "data": [
    {
      "id": "video_123",
      "object": "video",
      "model": "sora-2",
      "status": "completed"
    }
  ],
  "object": "list"
}

Returns Examples

{
  "data": [
    {
      "id": "video_123",
      "object": "video",
      "model": "sora-2",
      "status": "completed"
    }
  ],
  "object": "list"
}