Layout - spoolpdf

Paper

Named sizes: A0–A6, Letter, Legal, Tabloid, Ledger (default A4). Custom: "210mmx297mm" or 11x17 (inches when units are omitted). Or pair paper_width / paper_height. Single scrolling page: "format": "1024xauto" (unitless width is CSS pixels, ÷96 → inches) or "single_page": true. Do not combine with pages.

{"html": "<div id=\"app\">…</div>", "format": "1024xauto"}

Margins, header, footer

Header/footer HTML supports only the page and total placeholders (double curly braces). No other tokens are rewritten.

curl -sS -o letter.pdf \
  -X POST "$SPOOLPDF_BASE_URL/v1/render" \
  -H "Authorization: Bearer $SPOOLPDF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<main><h1>Letter</h1></main>",
    "margin": {"top":"24mm","right":"16mm","bottom":"24mm","left":"16mm"},
    "header": {"html":"<div style=\"font-size:10px\">Acme Co</div>","height":"12mm"},
    "footer": {"html":"<div style=\"font-size:10px\">Page {{page}} / {{total}}</div>","height":"12mm"}
  }'

print_background includes CSS backgrounds. landscape rotates the page. scale / zoom (alias) defaults to 1.

⌘I