Skip to content

List recent generation jobs

GET
/v1/jobs

Returns a paginated list of your recent generation jobs, newest first. Each entry includes the job status, operation type, and — for completed jobs — the generation result with image URLs.

Use limit and offset for pagination. The total field tells you how many jobs exist in total.

limit

Maximum number of results to return.

integer
default: 20

Maximum number of results to return.

offset

Number of results to skip for pagination.

integer
0

Number of results to skip for pagination.

OK

object
generations

List of recent generation jobs for the authenticated user.

array | null
object
completed_at

UTC timestamp when the job finished (completed or failed). Omitted if pending.

null | string format: date-time
created_at

UTC timestamp when the job was created.

string format: date-time
error

Error details. Present only when status is failed.

object
code

Machine-readable error code (e.g. content_rejected, insufficient_credits).

string
message

Human-readable description of why the job failed.

string
job_id

Unique async job identifier.

string format: uuid
result

Full generation result (same shape as synchronous create response). Present only when status is completed.

scenes_completed

Number of scenes that have been generated so far.

integer
scenes_total

Total number of scenes requested.

integer
started_at

UTC timestamp when processing began. Omitted if not yet started.

null | string format: date-time
status

Job status: pending, processing, completed, or failed.

string
limit

Maximum number of results returned in this response.

integer
offset

Number of results skipped (for pagination).

integer
total

Total number of generation jobs matching the query (before limit/offset).

integer

Bad Request

object
details
error
string
message
string
request_id
string

Unauthorized

object
details
error
string
message
string
request_id
string

Payment Required

object
details
error
string
message
string
request_id
string

Forbidden

object
details
error
string
message
string
request_id
string

Not Found

object
details
error
string
message
string
request_id
string

Conflict

object
details
error
string
message
string
request_id
string

Unprocessable Entity

object
details
error
string
message
string
request_id
string

Too Many Requests

object
details
error
string
message
string
request_id
string

Unavailable For Legal Reasons

object
details
error
string
message
string
request_id
string

Internal Server Error

object
details
error
string
message
string
request_id
string

Bad Gateway

object
details
error
string
message
string
request_id
string

Service Unavailable

object
details
error
string
message
string
request_id
string