API guides

Validate data without rendering

Check a payload against the selected template contract before generating a document.

Reviewed 2026-08-05 · PDFDesignAPI Engineering

Validation endpoint

POST /api/v1/templates/:templateUuid/validate applies the same schema checks without producing a PDF.

curl -X POST "https://pdfdesignapi.com/api/v1/templates/TEMPLATE_UUID/validate" \
  -H "Authorization: Bearer API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data":{"customer":{"name":"Example BV"}}}'

When to use it

Validate fixtures in CI, preflight user-entered data, and check integration compatibility before a template promotion.

Batch generation validates every item before creating durable jobs.

Fixing failures

Use the returned field paths and rules to correct the payload or update the template schema.

Do not retry an unchanged validation error.

Was this page helpful?

Need help with an implementation detail?

Contact technical support →