Skip to main content
GET
Returns the async jobs this account has submitted, newest first: renders, videos, uploads, and photo mockup creates and renders. Narrow the page with kind, and with mockup_uuid to read the jobs submitted against one mockup, such as its videos. Pass a page’s next_cursor back as cursor to read the page after it; on the last page next_cursor is null. Every item carries the same fields as Retrieve a single job, plus duration_seconds, audio, mockup_name and poster_url, so a list view can draw a row without polling each job on its own.
credits_charged is the net amount a job cost. A job that failed or was cancelled reports 0, because its credits go back to the account.

Authorizations

x-api-key
string
header
required

API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys

Query Parameters

kind
string

Filter by job kind: video | render | upload | 2d_create | 2d_render | photo_mockup_create | photo_mockup_render. A photo-mockup kind selects both spellings of that job, and the listed jobs are spelled the way you asked. Omit for all kinds, each spelled as it was submitted.

mockup_uuid
string

Filter by source mockup UUID (e.g. a mockup's videos). Omit for all mockups. Raw-image videos (no source mockup) are never returned by this filter.

limit
integer
default:20

Max jobs per page (1-50).

Required range: 1 <= x <= 50
cursor
string

Opaque cursor from a prior page's next_cursor.

Response

200 - application/json

Successful Response

A page of your jobs, newest first.

jobs
JobListItem · object[]
required

The jobs on this page, newest first.

next_cursor
string | null

Send this back as cursor to read the next page, and null when this is the last page.