Merge PDF Documents for Streamlined Report Compilation

Share this page

Assemble Complete Reports from Separate PDF Sources

Business reports rarely originate as one finished document. Financial results may come from an accounting platform, operating metrics from a business-intelligence system, and narrative analysis from another team. Research reports, audit packages, board materials, and client deliverables follow the same pattern. The challenge is assembling those sections in a defined order every time the underlying data changes.

The pdfRest Merge PDFs API Tool joins any number of PDF files or selected page ranges into one consolidated document. It uses Adobe PDF technology to build an optimized output rather than treating the source files as an unstructured bundle. A report-generation application can therefore turn several independently produced sections into a consistent deliverable without opening them in a desktop editor.

Control Which Pages Enter the Report

Merge PDFs can include complete documents or precise page selections from each source. For every input, the request supplies a corresponding pages[] value and type[] value. Use type[]=file for an uploaded file and type[]=id for a resource ID returned by an earlier pdfRest operation. Inputs are processed in request order, so the application controls the final sequence.

Page selections can contain individual pages, ranges, combinations such as 1,3-6,10, the last keyword, or descending ranges when reverse order is useful. This makes the endpoint suitable for more than simple concatenation. A reporting system can take the executive summary from one file, a selected financial section from another, and a complete appendix from a third without creating temporary PDFs for each excerpt.

For example, a quarterly-report service can receive executive-summary.pdf, financial-results.pdf, and operating-metrics.pdf. It sends the files in the approved order, includes all pages from each, and names the result quarterly_report. When a later quarter arrives, the application repeats the same assembly rule with new source documents.

Combine Uploaded Files and Prior API Outputs

A source does not have to begin as a local PDF. If a chart, spreadsheet, Word document, image, or HTML report first passes through another pdfRest tool, its returned resource ID can be supplied to Merge PDFs with id[]. Uploaded PDFs and resource IDs can appear in the same request as long as each has a matching type[] and pages[] entry.

This chainable design keeps document assembly close to the transformations that precede it. An application can convert source formats, select the required pages, and create the combined report without downloading every intermediate file. The merged output receives its own resource ID, which can continue to page numbering, watermarking, compression, PDF/A conversion, encryption, or another finishing operation.

Make Report Assembly Repeatable

The cURL request below combines three complete PDF reports in the order supplied.

Merge Three Report Sections Code Example | Load this into API Lab↗

# By default, this request uses the US-based API service.
API_URL="https://api.pdfrest.com"

# For the EU-based service, use:
# API_URL="https://eu-api.pdfrest.com"

curl -X POST "$API_URL/merged-pdf" \
  -H "Accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -F "file=@/path/to/financial_results.pdf" \
  -F "pages[]=all" -F "type[]=file" \
  -F "file=@/path/to/operating_metrics.pdf" \
  -F "pages[]=all" -F "type[]=file" \
  -F "file=@/path/to/narrative_analysis.pdf" \
  -F "pages[]=all" -F "type[]=file" \
  -F "output=quarterly_report"

The same request structure can be generated from a report manifest stored by the application. Each manifest entry can identify the source, included pages, and position, giving the organization a reusable assembly definition instead of a recurring manual task. pdfRest handles the PDF-level work while the reporting system retains control over business rules and document order.

Use API Lab to build a request and review the Merge PDFs API reference for current multipart fields and page-selection syntax.

Merge PDFs