​
Description

This endpoint merges multiple PDF files into a single PDF.

​
Endpoint

POST /api/v1/merge-pdfs

​
Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

​
Request Body

{
  "inputMethod": "string", // Required. Either "url" or "base64"
  "files": ["string"], // Required. Array of URLs or base64-encoded PDF contents
  "metadata": {
    // Optional. Metadata for the merged PDF
    "Title": "string",
    "Author": "string",
    "Subject": "string",
    "Keywords": "string"
  },
  "pdfa": "string", // Optional. PDF/A compliance level: "PDF/A-1b", "PDF/A-2b", or "PDF/A-3b"
  "pdfua": "boolean", // Optional. Enable PDF/UA compliance
  "requestSource": "string" // Optional. Source of the request
}

​
Responses

​
Success (200)

Returns the URL of the merged PDF.

{
  "url": "string" // URL to the merged PDF file
}

​
Notes

  • Credit usage: 5 credits per 100MB of output PDF size
  • Requires at least 2 PDF files to merge
  • Optional PDF/A and PDF/UA compliance
  • Optional metadata for the merged PDF
  • Files are temporarily stored (24-hour retention)

​
Rate Limiting

Rate limit headers are included in the response.

Write PDF Metadata