Skip to main content
The PDF editing endpoints all use multipart/form-data and return a PDF.

​
Supported Endpoints

EndpointCreditsInput shape
POST /pdf/merge1multiple files, optional order
POST /pdf/pages/remove1file, pages
POST /pdf/compress2file, 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