PDF Merge and Compress

Merges PDFs in the order given and, with compress: true, compresses the result. A single file with compress: true compresses that file only.

Asynchronous. Every valid request returns 202 Accepted with a request_id. When processing finishes, the result is POSTed to webhook_url with the PDF as base64 (event: pdf.process.completed), or an error (event: pdf.process.failed). A failed webhook is retried after 30 s, 2 min and 10 min. The PDF can also be collected from GET /api/v1/pdf/process/{request_id} while it is still held.

Limits: 1–5 files by default (your account can be set up for more, up to 20; ask your account manager), 50 MB in total, not password-protected. reference_id must be unique — sending it again returns the original request (duplicate: true) and is not charged again. webhook_url must be https and must accept large bodies (up to ~70 MB).

Compression levels: compression makes the file smaller by reducing the quality of images and scanned pages inside the PDF. Typed text stays sharp at every level. The higher the level, the smaller the file, but images look less detailed. low: light compression (images kept at 300 dpi, print quality). The file shrinks the least, and images and scans still print clearly. Use it when the document will be printed or has fine detail, such as small print on scanned pages, stamps or signatures. medium (default): balanced compression (150 dpi). The file is noticeably smaller and still easy to read on screen and in ordinary prints. Suits most documents, such as agreements, forms and KYC packs. high: strong compression (72 dpi, screen quality). The file is the smallest, but images and scans may look blurry when you zoom in or print. Use it only when file size matters most, for example email attachments or portal upload limits. How much the file shrinks depends on its content. PDFs with many photos or scanned pages shrink a lot, while PDFs that are mostly typed text are already small and shrink very little. If compression cannot make the file smaller, you receive the original (uncompressed) PDF and a warning in the response.

Storage: files are held temporarily in encrypted private storage only while the request is in progress, and deleted as soon as the webhook is delivered (or 1 hour after delivery finally fails).

Notes: merging or compressing invalidates existing digital signatures — merge first, then eSign. Compression may flatten form fields. One flat charge per successful request.

Returns the same body as the webhook. data.pdf (base64) is included while the result is held: status completed (webhook not yet delivered or retrying) and delivery_failed (for 1 hour). After a successful webhook the status is delivered and the PDF has been deleted. Other values: accepted, processing, expired, failed (see error.message). Reading the status is not charged.