List Render Jobs

List your workspace's async render jobs, newest first, with optional status filter and cursor pagination.

Updated

List the async render jobs in your workspace, newest first.

GET https://api.orshot.com/v1/studio/render-jobs?status=processing&limit=20

Query parameters#

ParameterTypeDescription
statusstringOptional filter: queued, processing, succeeded, failed, or canceled. An unknown value answers 400 (invalid-status-filter).
limitnumberHow many to return. Default 20, max 100.
cursornumberFor the next page, pass the next_cursor from the previous response.

Response#

data is an array of job objects, newest first. pagination.next_cursor is the id to pass as cursor for the next (older) page; it is null on the last page.

{
  "data": [
    { "id": 1208, "status": "queued",     "finished": false, "created_at": "…" },
    { "id": 1207, "status": "processing", "finished": false, "created_at": "…" },
    { "id": 1206, "status": "succeeded",  "finished": true,  "result": { … }, "created_at": "…" }
  ],
  "pagination": { "has_more": true, "next_cursor": 1206 }
}

Paging through every job#

let cursor;
do {
  const url = new URL("https://api.orshot.com/v1/studio/render-jobs");
  url.searchParams.set("limit", "100");
  if (cursor) url.searchParams.set("cursor", cursor);
  const res = await fetch(url, { headers: { Authorization: "Bearer <ORSHOT_API_KEY>" } });
  const { data, pagination } = await res.json();
  // …process data…
  cursor = pagination.next_cursor;
} while (cursor);

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 50+ integrations
  • White-label embed for your own app
  • 30 free credits — no credit card required