PDF/A & PDF/UA

Converts one or more PDF files into a standardized format.

PDF/A: Specialized for the digital preservation of electronic documents (Archival).
PDF/UA: Specialized for Universal Accessibility, ensuring documents are accessible to assistive technologies.

LibreOffice Dependency

This endpoint relies on LibreOffice to re-process documents. This operation is generally more resource-intensive (CPU & RAM) than simple merges or splits.

POST/forms/pdfengines/convert

Headers

Gotenberg-Output-Filenamestring

The filename of the resulting file - Gotenberg automatically appends the file extension. Defaults to a random UUID filename.

Gotenberg-Tracestring

A custom request ID to identify the request in the logs; overrides the default UUID.

Form Fields

pdfaenum

Converts to a specific PDF/A archival standard. Options: 'PDF/A-1b', 'PDF/A-2b', 'PDF/A-3b'.

pdfuaboolean

Enables PDF/UA (Universal Accessibility) compliance.

Default:false

Form Files

filesfile[]required

PDF files to convert.

Example Request

cURL
curl \
--request POST http://localhost:3000/forms/pdfengines/convert \
--form files=@/path/to/pdf.pdf \
--form pdfa=PDF/A-1b \
--form pdfua=true \
-o my.pdf

Responses

200 OK
400 Bad Request
503 Service Unavailable

The converted PDF file.

Content-Disposition: attachment; filename={output-filename.pdf}
Content-Type: {content-type}
Content-Length: {content-length}
Gotenberg-Trace: {trace}
Body: {output-file}

The request had one ore more invalid form fields.

Content-Type: text/plain; charset=UTF-8
Gotenberg-Trace: {trace}
Body: {error}

The request did not complete within the configured maximum duration.

Content-Type: text/plain; charset=UTF-8
Gotenberg-Trace: {trace}
Body: Service Unavailable

❤️ Become a sponsor