Skip to content
Coming soon. The hosted API is not live yet, and this page describes the planned service as of 16 November 2026. Get notified when it opens.

pdf.merge

Merge PDFs in the given order.

POST /v1/pdf/merge

Input several files, sent as multipart/form-data; the optional options part is a JSON object
Output one PDF
Credits 1 credit per 10 pages, rounded up to whole blocks of 10 pages, with a minimum of 1 credit
Limits [size, page and time limits: no claim ID yet]
Reads or changes the document returns a changed copy
Error statuses 400, 413, 422, 500, 501, 504 (see Errors)
Option Type Required Default Description
bookmarks string no What to do with bookmarks. Default concat. concat: One top-level entry per input. The default. flatten: All bookmarks in one flat list. discard: No bookmarks.
password string no Password shared by every encrypted input.
Terminal window
curl -sS -f -X POST "$PDFLUENT_API_URL/v1/pdf/merge" \
-H "x-api-key: $PDFLUENT_API_KEY" \
-o result.pdf

The key goes in the x-api-key header; see Authentication. Every response carries x-pdfluent-pages and x-pdfluent-credits.