PDF Workflow Guide

The PDF editing endpoints all use multipart/form-data and return a PDF.

Supported Endpoints

Endpoint	Credits	Input shape
`POST /pdf/merge`	1	multiple `files`, optional `order`
`POST /pdf/pages/remove`	1	`file`, `pages`
`POST /pdf/compress`	2	`file`, optional `quality`

Merge

Send between 2 and 20 PDF files. If you need a custom output order, pass an order field containing a JSON array of zero-based file indexes.

curl --request POST \
  --url https://api.iyzpdf.com/v1/pdf/merge \
  --header "X-API-Key: $IYZPDF_API_KEY" \
  --form "files=@cover.pdf" \
  --form "files=@appendix.pdf" \
  --form 'order=[0,1]' \
  --output merged.pdf

Remove Pages

Send a single PDF and a JSON array of 1-indexed page numbers.

curl --request POST \
  --url https://api.iyzpdf.com/v1/pdf/pages/remove \
  --header "X-API-Key: $IYZPDF_API_KEY" \
  --form "file=@contract.pdf" \
  --form 'pages=[2,4]' \
  --output contract-trimmed.pdf

Compress

Compression accepts one PDF plus an optional quality level:

low
medium
high

curl --request POST \
  --url https://api.iyzpdf.com/v1/pdf/compress \
  --header "X-API-Key: $IYZPDF_API_KEY" \
  --form "file=@catalog.pdf" \
  --form "quality=medium" \
  --output catalog-compressed.pdf

Limits

Merge accepts 2 to 20 PDFs
Authenticated PDF editing uploads are limited to 100 MB
Remove pages and compress accept a single valid PDF
Merge uses total upload size, not per-file size

Getting Started

Workflows

Supported Endpoints

Merge

Remove Pages

Compress

Limits

​Supported Endpoints

​Merge

​Remove Pages

​Compress

​Limits

Supported Endpoints

Merge

Remove Pages

Compress

Limits