---
title: "Get render quota"
method: GET
path: "/renders/limits"
tags: ["Renders"]
---

# Get render quota

`GET /renders/limits`

## Request

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

Returns the workspace's current render usage and plan-level render limits. Use this before kicking off a render to avoid being throttled — if `usage.total_pending >= usage.max_concurrent`, a new render will be rejected with `429`.

## Response `200`

Response for status 200

- object
  - `usage` object, required
    - `active_count` number, required: Renders currently encoding
    - `queued_count` number, required: Renders waiting in the queue
    - `total_pending` number, required: active + queued
    - `max_concurrent` number, required: Max simultaneous renders allowed by the workspace's plan
  - `plan` object, required
    - `video_quality` string, required: Maximum output resolution, e.g. `720p` or `1080p`
    - `watermark` boolean, required: `true` if rendered videos carry a CutPro watermark
    - `priority_processing` boolean, required: `true` if this workspace is on the priority render queue
    - `max_concurrent_renders` number, required
    - `render_expiry_hours` number, required: Hours after which a completed render's file is purged from storage

---

[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)