Jobs

Retrieve a list of jobs

List the caller's async jobs (render, video, upload, or photo mockup creation), newest first and paginated by cursor. Optionally filter by kind and/or mockup_uuid (e.g. one mockup's videos). Each item has the SAME shape as GET /api/v1/jobs/{job_id} plus list display fields (duration_seconds/audio/mockup_name/poster_url).

get/api/v1/jobs

Request

  • Base URL: https://api.sudomock.com
  • URL: https://api.sudomock.com/api/v1/jobs
  • Auth: API key in header x-api-key

Query parameters

kindstring

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_uuidstring

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.

limitinteger

Max jobs per page (1-50).

cursorstring

Opaque cursor from a prior page's next_cursor.

Response

Successful Response

next_cursorstring nullable

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

Example response

{
  "jobs": [
    {
      "audio": false,
      "created_at": "2026-09-18T10:24:31.482913+00:00",
      "credits_charged": 38,
      "duration_seconds": 4,
      "job_id": "5f1c0b2a-7d43-4e9a-8c16-0b5d3f7a2e94",
      "kind": "video",
      "mockup_name": "Heavyweight Tee",
      "model": "veo-3.1-fast",
      "outcome_tier": "standard",
      "poster_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/poster.webp",
      "result_url": "https://cdn.sudomock.com/mockup-assets/videos/5f1c0b2a/clip.mp4",
      "status": "succeeded",
      "updated_at": "2026-09-18T10:41:07.118204+00:00",
      "error": null,
      "mockup_uuid": null,
      "payg": null,
      "watermark": null
    }
  ],
  "next_cursor": "MjAyNi0wOS0xOFQxMDoyNDozMS40ODI5MTMrMDA6MDB8NWYxYzBiMmEtN2Q0My00ZTlhLThjMTYtMGI1ZDNmN2EyZTk0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.