Skip to main content
GET
/
v1
/
videos
/
{video_id}
OpenAI video status
curl --request GET \
  --url http://sandbox.mintlify.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_123456789",
  "object": "video",
  "created_at": 1741570283,
  "completed_at": 1741570383,
  "model": "sora-2",
  "status": "pending",
  "progress": 50,
  "expires_at": 1741656683,
  "seconds": "4",
  "size": "720x1280",
  "remixed_from_video_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>",
    "type": "<string>"
  }
}
Use this endpoint to query the current status, progress, and error state of a video-generation task.
  • Authenticate with Authorization: Bearer {API_KEY}
  • The key path parameter is video_id
  • This endpoint is normally polled after task creation
  • If you maintain an internal job table, store provider status separately from product status

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
video_id
string
required

Video ID

Example:

"video_123456789"

Response

Successful video task status response

​
id
string
required

Video task ID.

Example:

"video_123456789"

​
object
enum<string>
required

Object type.

Available options:
video
​
status
enum<string>
required

Current task status.

Available options:
pending,
in_progress,
completed,
failed
​
created_at
integer<int64>

Creation timestamp.

​
completed_at
integer<int64>

Completion timestamp.

​
model
string

Model used for generation.

​
progress
integer

Task progress percentage.

Required range: 0 <= x <= 100
​
expires_at
integer<int64>

Expiration timestamp for the generated asset.

​
seconds
string

Video duration in seconds.

​
size
enum<string>

Video resolution.

Available options:
720x1280,
1280x720
​
remixed_from_video_id
string

Source video ID when the task comes from remix.

​
error
object