Skip to content
SayGMDocs
Dashboard

List video jobs

GET
/videos
curl --request GET \
--url 'https://api.saygm.com/v1/videos?limit=20&order=asc' \
--header 'Authorization: Bearer <token>'

List video jobs for the authenticated account. Results are ordered by creation time and use an id cursor.

after
string

Return jobs after this job id.

limit
integer
default: 20 >= 1 <= 100

Maximum number of jobs to return. Defaults to 20.

order
string
default: desc
Allowed values: asc desc

Creation-time order. Defaults to desc.

A page of video jobs.

Media typeapplication/json
object
object
required
string
Allowed value: list
data
required
Array<object>
object
id
required
string
object
required
string
Allowed value: video
model
required
string
seconds
required

Requested duration in seconds, serialized as a numeric string.

string
size
required
string
created_at
required

Creation time as Unix seconds.

integer
completed_at
required

Completion time as Unix seconds, or null until complete.

integer | null
expires_at
required

Content expiry time as Unix seconds.

integer
status
required
string
Allowed values: queued in_progress completed failed
error
required
Any of:
object
code
required
string
message
required
string
key
additional properties
any
usage
required
Any of:
object
output_video_seconds
required
integer
cost
required

Settled buyer charge in USD.

string
cost_nano_usd
required

The same charge in integer nano-USD.

integer
progress
integer
<= 100
first_id
required
string | null
last_id
required
string | null
has_more
required
boolean
Example
{
"object": "list",
"data": [
{
"object": "video",
"status": "queued"
}
]
}

A query parameter is invalid.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The API key is missing or invalid.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}

The service cannot complete the request right now.

Media typeapplication/json
object
error
required
object
message
required
string
type
required
string
code
required
string
param
required
string | null
key
additional properties
any
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
key
additional properties
any
Example
{
"billing_status": "settled"
}