API guides

Generate a PDF synchronously

Send JSON data and receive a PDF in the same HTTP request.

Reviewed 2026-08-05 · PDFDesignAPI Engineering

Endpoint

POST /api/v1/generate/single/:templateUuid returns a binary PDF when rendering succeeds.

The body contains a data object matching the selected template contract.

POST https://pdfdesignapi.com/api/v1/generate/single/TEMPLATE_UUID
Authorization: Bearer API_TOKEN
Content-Type: application/json

{"data":{"customer":{"name":"Example BV"}}}

Version selection

Select either an immutable numeric version or a named environment when the request options support template selection. Do not send both.

Use production for normal application traffic and explicit versions for deterministic tests or controlled replays.

Handle the binary response

Treat a successful response as application/pdf and stream it to storage or the end user.

Do not parse the PDF body as JSON. Error responses use the documented structured error format instead.

Was this page helpful?

Need help with an implementation detail?

Contact technical support →