Skip to main content
POST
/
api
/
v1
/
merge-pdfs
Merge PDFs
curl --request POST \
  --url https://app.dumplingai.com/api/v1/merge-pdfs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputMethod": "url",
  "files": [
    "https://example.com/cover.pdf",
    "https://example.com/appendix.pdf"
  ],
  "metadata": {
    "Title": "2025 Strategy Overview"
  }
}'
{
  "url": "<string>"
}

​
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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
inputMethod
enum<string>
required

Indicates whether binary content is supplied via URL or base64-encoded string.

Available options:
url,
base64
​
files
string[]
required

Array of PDF URLs or base64-encoded PDF contents to merge.

Minimum length: 2
​
metadata
object

Optional metadata map to embed within the merged PDF.

​
pdfa
enum<string>

Optional PDF/A compliance level to apply when merging.

Available options:
PDF/A-1b,
PDF/A-2b,
PDF/A-3b
​
pdfua
boolean

Whether to attempt enabling PDF/UA compliance.

​
requestSource
enum<string>

Optional identifier describing where the API request originated.

Available options:
API,
WEB,
MAKE_DOT_COM,
ZAPIER,
N8N,
PLAYGROUND,
DEFAULT_AUTOMATION,
AGENT_PREVIEW,
AGENT_LIVE,
AUTOPILOT,
STUDIO

Response

Merged PDF returned.

​
url
string<uri>
required

Temporary download URL for the merged PDF.