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

# List renders

`GET /renders`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/renders`
- Auth: API key in header `X-Api-Key`

Returns a paginated list of all your render jobs, newest first. Filter by `status` to focus on processing, completed, or failed renders.

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 20, max: 100)
- `status` 'processing' | 'completed' | 'failed' | 'expired'

## Response `200`

Response for status 200

- object
  - `renders` object[], required
    - `id` string, required: Unique render ID
    - `edit_id` string, required: Edit this render was produced from. It never expires: pass it to `POST /renders` for a fresh file, or to `POST /posts` to publish it.
    - `name` string, nullable, required: Name of the edit / clip being rendered
    - `status` 'queued' | 'active' | 'completed' | 'failed' | 'cancelled' | 'expired' | 'waiting_quality', required
    - `progress` number, required: Render progress from 0 to 100
    - `output_resolution` string, nullable, required: Output resolution, e.g. `720p` or `1080p`
    - `created_at` string, required: ISO 8601 timestamp of when the render was queued
    - `started_at` string, nullable, required: ISO 8601 timestamp of when rendering started
    - `completed_at` string, nullable, required: ISO 8601 timestamp of when the render finished
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)