---
title: "List render jobs"
method: GET
path: "/api/jobs"
tags: ["Render"]
---

# List render jobs

`GET /api/jobs`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/jobs`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

List the account's render jobs, newest first. Filter by output type with `type`.

## Query parameters

- `page` integer
- `limit` integer
- `type` 'video' | 'image'

## Response `200`

Render jobs for the authenticated account

- JobList
  - `jobs` JobSummary[], required
    - `id` string, required
    - `status` 'queued' | 'processing' | 'completed' | 'failed', required: Job status
    - `jobType` 'video' | 'image', required
    - `name` string, nullable
    - `creditsEstimated` number, nullable
    - `creditsConsumed` number, nullable
    - `videoDuration` number, nullable: Output duration in seconds (null for images)
    - `videoResolution` string, nullable
    - `outputUrl` string, nullable: CDN URL of the finished output (null before completion and after expiry)
    - `thumbnailUrl` string, nullable
    - `errorMessage` string, nullable
    - `templateId` string, nullable: Source template, when the job was rendered from one
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time, nullable
    - `outputExpiresAt` string, date-time, nullable: Availability deadline based on the plan recorded for this render, starting at completion. URLs are withheld after this time.
    - `outputExpiredAt` string, date-time, nullable: When expiration cleanup was recorded. Check outputExpiresAt even while cleanup is pending.
    - `outputCleanupStatus` string, nullable: Output cleanup progress; failed storage deletion or cache purges are retried.
  - `pagination` Pagination, required: Standard pagination envelope for list endpoints.
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
    - `hasNext` boolean: Whether there are more pages after the current one
    - `hasPrev` boolean: Whether there are pages before the current one

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

[API](https://skmtc.dev/zvid/apis/zvid-api.md) · [All operations](https://skmtc.dev/zvid/apis/zvid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zvid/apis/zvid-api/revisions/8a665b293b37?raw)