Render endpoint

{
  "template": "invoice",
  "html": null,
  "data": { "client": "Acme Ltd", "total": "$1,480.00" },
  "format": "pdf",
  "pdf": {
    "pageFormat": "A4",
    "landscape": false,
    "printBackground": true,
    "margin": { "top": "20mm", "right": "16mm", "bottom": "20mm", "left": "16mm" },
    "scale": 1
  },
  "png": {
    "fullPage": true,
    "width": 1080,
    "height": 1350
  },
  "watermark": true
}

curl -X POST https://api.renderly.dev/v1/render \
  -H "Authorization: Bearer rndr_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Contract</h1><p>Between {{party_a}} and {{party_b}}.</p>",
    "data": { "party_a": "Acme", "party_b": "Beta" },
    "format": "pdf",
    "pdf": { "pageFormat": "A4", "printBackground": true, "margin": { "top": "25mm", "bottom": "25mm" } }
  }' --output contract.pdf

curl -X POST https://api.renderly.dev/v1/render \
  -H "X-API-Key: rndr_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "post-instagram",
    "data": { "title": "Winter sale" },
    "format": "png",
    "png": { "width": 1080, "height": 1350, "fullPage": false }
  }' --output post.png

import { writeFile } from "node:fs/promises"

const res = await fetch("https://api.renderly.dev/v1/render", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.RENDERLY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template: "invoice",
    data: { client: "Acme", total: "$1,480.00" },
    format: "pdf",
    pdf: { pageFormat: "A4", landscape: false },
  }),
})

// On error, the body is JSON; on success, it's the binary.
if (!res.ok) {
  const { error } = await res.json()
  throw new Error(`render failed: ${error.code} — ${error.message}`)
}

const bytes = Buffer.from(await res.arrayBuffer())
await writeFile("invoice.pdf", bytes)

console.log({
  ms: res.headers.get("X-Render-Ms"),
  engine: res.headers.get("X-Render-Engine"),
  hash: res.headers.get("X-Renderly-Document-Hash"),
  verify: res.headers.get("X-Renderly-Verify-Url"),
})

import os
import requests

res = requests.post(
    "https://api.renderly.dev/v1/render",
    headers={"Authorization": f"Bearer {os.environ['RENDERLY_API_KEY']}"},
    json={
        "template": "invoice",
        "data": {"client": "Acme", "total": "$1,480.00"},
        "format": "pdf",
        "pdf": {"pageFormat": "A4", "landscape": False},
    },
    timeout=60,
)

# On error, the body is JSON; on success, it's the binary.
if res.status_code != 200:
    err = res.json()["error"]
    raise RuntimeError(f"render failed: {err['code']} — {err['message']}")

with open("invoice.pdf", "wb") as f:
    f.write(res.content)

print({
    "ms": res.headers["X-Render-Ms"],
    "engine": res.headers["X-Render-Engine"],
    "hash": res.headers["X-Renderly-Document-Hash"],
    "verify": res.headers.get("X-Renderly-Verify-Url"),
})

// In an endpoint on YOUR server that forwards the PDF to the browser:
const upstream = await fetch("https://api.renderly.dev/v1/render", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.RENDERLY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ template: "invoice", data }),
})

return new Response(upstream.body, {
  headers: {
    "Content-Type": "application/pdf",
    "Content-Disposition": 'attachment; filename="invoice.pdf"',
  },
})