Skip to main content
POST
https://api.iyzpdf.com/v1
/
pdf
/
merge
curl
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
{
  "fileName": "output.pdf",
  "size": 183240,
  "creditsUsed": 1,
  "creditsRemaining": 49,
  "contentType": "application/pdf"
}

​
Notes

  • Credits: 1
  • Upload between 2 and 20 PDF files
  • The total authenticated upload limit is 100 MB
  • Every uploaded part must be a valid PDF
  • Use order when the upload order is not your desired output order
  • The generated output file name is merged.pdf

Authorizations

​
X-API-Key
string
header
required

Send your server-side API key in the X-API-Key header.

Body

multipart/form-data
​
files
file[]
required
Required array length: 2 - 20 elements
​
order
string

Optional JSON array describing the final file order, for example [0,2,1].

Response

Successful response.

​
fileName
string
required
​
size
integer<int32>
required
​
creditsUsed
integer<int32>
required
​
contentType
string
required
​
creditsRemaining
integer<int32> | null