---
title: "List renders"
method: GET
path: "/renders"
tags: ["Rendering"]
---

# List renders

`GET /renders`

## Request

- Base URL: `https://api.vidmoat.com/v1`
- URL: `https://api.vidmoat.com/v1/renders`
- Auth: HTTP bearer

List your render jobs, newest first. Filter by `projectId` or `status`, and page with `cursor`.

## Query parameters

- `limit` integer
- `cursor` string
- `projectId` string
- `status` string

## Response `200`

List renders

- object
  - `data` object[]: Render jobs.
    - `id` string: Render job id.
    - `projectId` string: The project rendered.
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED': Where the job is.
    - `progress` integer: 0 to 100.
    - `format` string: `mp4`, `webm` or `gif`.
    - `resolution` string: `full` or `half`.
    - `quality` string: `draft`, `standard` or `high`.
    - `url` string, nullable: The download URL once `COMPLETED`.
    - `error` string, nullable: Why it failed, when `FAILED`.
    - `createdAt` string: ISO 8601 time.
    - `updatedAt` string: ISO 8601 time.
  - `hasMore` boolean: Another page exists.
  - `nextCursor` string, nullable: Pass as `cursor`.

---

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