API Reference

Videos

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List videos

Deprecated: The Sora API is scheduled to permanently shut down on September 24, 2026.

$ openai videos list

GET/videos

List recently generated videos for the current project.

ParametersExpand Collapse

--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.

ReturnsExpand Collapse

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

data: array of Video { id, completed_at, created_at, 10 more }

A list of items

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.

List videos

CLI Tool

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

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

{
  "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"
}