From HTML
Send a complete HTML document to POST /render/html. Best when you already produce markup or use a
templating engine. HTML to PDF →
Accessible PDFs, by the standard.
A small, self-hosted HTTP API that turns HTML, URLs and JSON templates into PDF/A-3a documents with full PDF/UA accessibility — tagged structure, declared language and embedded fonts — in a single container with no external services.
Three ways to create a PDF
Pick the entry point that matches what you already have — all three produce the same accessible PDF/A-3a output.
From a URL
Send a public URL to POST /render/url and the API fetches the HTML for you. Best for static
sites or server-rendered pages. URL to PDF →
From a template
Send a JSON template of rows and typed blocks to POST /render/template. Best for structured
documents like invoices. Templates →
Validate & verify
Check any PDF against PDF/A-3a and PDF/UA-1 with POST /validate, or confirm a document came
from this API. Quick Start →
Run it in one command
The API ships as a single container — no databases, no headless browser, no external services.
docker run -p 8080:8080 ghcr.io/bambamboole/pdf-ua-api:latest
Then convert your first document:
curl -X POST http://localhost:8080/render/html \
-H "Content-Type: application/json" \
-d '{"html":"<html><head><title>Document</title></head><body><h1>Hello World</h1></body></html>"}' \
--output output.pdf
PDF render endpoints return application/pdf unless you explicitly send Accept: application/json,
which returns { validation, pdf } with the PDF base64-encoded. That JSON response mode cannot be
combined with X-Upload-Url.