Combine PDF Files
Combine two or more documents into a single PDF file
REST API
See our public API Reference for Combine PDF
Combine Files
This sample combines up to 20 PDF files into a single PDF file.
Please refer the API usage guide to understand how to use our APIs.
Java
.NET
Node JS
Python
REST API
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_java_samples// Run the sample:// mvn -f pom.xml exec:java -Dexec.mainClass=com.adobe.pdfservices.operation.samples.combinepdf.CombinePDFpublic class CombinePDF {// Initialize the logger.private static final Logger LOGGER = LoggerFactory.getLogger(CombinePDF.class);public static void main(String[] args) {try (InputStream inputStream1 = Files.newInputStream(new File("src/main/resources/combineFilesInput1.pdf").toPath());InputStream inputStream2 = Files.newInputStream(new File("src/main/resources/combineFilesInput2.pdf").toPath())) {// Initial setup, create credentials instanceCredentials credentials = new ServicePrincipalCredentials(System.getenv("PDF_SERVICES_CLIENT_ID"),System.getenv("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadList<StreamAsset> streamAssets = new ArrayList<>();streamAssets.add(new StreamAsset(inputStream1, PDFServicesMediaType.PDF.getMediaType()));streamAssets.add(new StreamAsset(inputStream2, PDFServicesMediaType.PDF.getMediaType()));List<Asset> assets = pdfServices.uploadAssets(streamAssets);// Create parameters for the jobCombinePDFParams combinePDFParams = CombinePDFParams.combinePDFParamsBuilder().addAsset(assets.get(0)).addAsset(assets.get(1)).build();// Creates a new job instanceCombinePDFJob combinePDFJob = new CombinePDFJob(combinePDFParams);// Submit the job and gets the job resultString location = pdfServices.submit(combinePDFJob);PDFServicesResponse<CombinePDFResult> pdfServicesResponse = pdfServices.getJobResult(location, CombinePDFResult.class);// Get content from the resulting asset(s)Asset resultAsset = pdfServicesResponse.getResult().getAsset();StreamAsset streamAsset = pdfServices.getContent(resultAsset);// Creates an output stream and copy stream asset's content to itFiles.createDirectories(Paths.get("output/"));OutputStream outputStream = Files.newOutputStream(new File("output/combineFilesOutput.pdf").toPath());LOGGER.info("Saving asset at output/combineFilesOutput.pdf");IOUtils.copy(streamAsset.getInputStream(), outputStream);outputStream.close();} catch (IOException | ServiceApiException | SDKException | ServiceUsageException e) {LOGGER.error("Exception encountered while executing operation", e);}}}
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_net_samples// Run the sample:// cd CombinePDF/// dotnet run CombinePDF.csprojnamespace CombinePDF{class Program{private static readonly ILog log = LogManager.GetLogger(typeof(Program));static void Main(){//Configure the loggingConfigureLogging();try{// Initial setup, create credentials instanceICredentials credentials = new ServicePrincipalCredentials(Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_ID"),Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadusing Stream inputStream1 = File.OpenRead(@"combineFilesInput1.pdf");using Stream inputStream2 = File.OpenRead(@"combineFilesInput2.pdf");List<IAsset> assets = pdfServices.UploadAssets(new List<StreamAsset>(){new StreamAsset(inputStream1, PDFServicesMediaType.PDF.GetMIMETypeValue()),new StreamAsset(inputStream2, PDFServicesMediaType.PDF.GetMIMETypeValue())});// Create parameters for the jobCombinePDFParams combinePDFParams = CombinePDFParams.CombinePDFParamsBuilder().AddAsset(assets[0]).AddAsset(assets[1]).Build();// Creates a new job instanceCombinePDFJob combinePDFJob = new CombinePDFJob(combinePDFParams);// Submits the job and gets the job resultString location = pdfServices.Submit(combinePDFJob);PDFServicesResponse<CombinePDFResult> pdfServicesResponse =pdfServices.GetJobResult<CombinePDFResult>(location, typeof(CombinePDFResult));// Get content from the resulting asset(s)IAsset resultAsset = pdfServicesResponse.Result.Asset;StreamAsset streamAsset = pdfServices.GetContent(resultAsset);// Creating output streams and copying stream asset's content to itString outputFilePath = "/output/combineFilesOutput.pdf";new FileInfo(Directory.GetCurrentDirectory() + outputFilePath).Directory.Create();Stream outputStream = File.OpenWrite(Directory.GetCurrentDirectory() + outputFilePath);streamAsset.Stream.CopyTo(outputStream);outputStream.Close();}catch (ServiceUsageException ex){log.Error("Exception encountered while executing operation", ex);}catch (ServiceApiException ex){log.Error("Exception encountered while executing operation", ex);}catch (SDKException ex){log.Error("Exception encountered while executing operation", ex);}catch (IOException ex){log.Error("Exception encountered while executing operation", ex);}catch (Exception ex){log.Error("Exception encountered while executing operation", ex);}}static void ConfigureLogging(){ILoggerRepository logRepository = LogManager.GetRepository(Assembly.GetEntryAssembly());XmlConfigurator.Configure(logRepository, new FileInfo("log4net.config"));}}}
Copied to your clipboard// Get the samples from http://www.adobe.com/go/pdftoolsapi_node_sample// Run the sample:// node src/combinepdf/combine-pdf.jsconst {ServicePrincipalCredentials,PDFServices,MimeType,CombinePDFJob,CombinePDFParams,CombinePDFResult,SDKError,ServiceUsageError,ServiceApiError} = require("@adobe/pdfservices-node-sdk");const fs = require("fs");(async () => {let readStream1;let readStream2;try {// Initial setup, create credentials instanceconst credentials = new ServicePrincipalCredentials({clientId: process.env.PDF_SERVICES_CLIENT_ID,clientSecret: process.env.PDF_SERVICES_CLIENT_SECRET});// Creates a PDF Services instanceconst pdfServices = new PDFServices({credentials});// Creates an asset(s) from source file(s) and uploadreadStream1 = fs.createReadStream("./combineFilesInput1.pdf");readStream2 = fs.createReadStream("./combineFilesInput2.pdf");const [inputAsset1, inputAsset2] = await pdfServices.uploadAssets({streamAssets: [{readStream: readStream1,mimeType: MimeType.PDF}, {readStream: readStream2,mimeType: MimeType.PDF}]});// Create parameters for the jobconst params = new CombinePDFParams().addAsset(inputAsset1).addAsset(inputAsset2);// Create a new job instanceconst job = new CombinePDFJob({params});// Submit the job and get the job resultconst pollingURL = await pdfServices.submit({job});const pdfServicesResponse = await pdfServices.getJobResult({pollingURL,resultType: CombinePDFResult});// Get content from the resulting asset(s)const resultAsset = pdfServicesResponse.result.asset;const streamAsset = await pdfServices.getContent({asset: resultAsset});// Creates an output stream and copy result asset's content to itconst outputFilePath = "./combineFilesOutput.pdf";console.log(`Saving asset at ${outputFilePath}`);const outputStream = fs.createWriteStream(outputFilePath);streamAsset.readStream.pipe(outputStream);} catch (err) {if (err instanceof SDKError || err instanceof ServiceUsageError || err instanceof ServiceApiError) {console.log("Exception encountered while executing operation", err);} else {console.log("Exception encountered while executing operation", err);}} finally {readStream1?.destroy();readStream2?.destroy();}})();
Copied to your clipboard# Get the samples https://github.com/adobe/pdfservices-python-sdk-samples# Run the sample:# python src/combinepdf/combine_pdf.py# Initialize the loggerlogging.basicConfig(level=logging.INFO)class CombinePDF:def __init__(self):try:file = open('./combineFilesInput1.pdf', 'rb')input_stream_1 = file.read()file.close()file = open('./combineFilesInput2.pdf', 'rb')input_stream_2 = file.read()file.close()# Initial setup, create credentials instancecredentials = ServicePrincipalCredentials(client_id=os.getenv('PDF_SERVICES_CLIENT_ID'),client_secret=os.getenv('PDF_SERVICES_CLIENT_SECRET'))# Creates a PDF Services instancepdf_services = PDFServices(credentials=credentials)# Creates an asset(s) from source file(s) and uploadstream_assets = [StreamAsset(input_stream_1, PDFServicesMediaType.PDF),StreamAsset(input_stream_2, PDFServicesMediaType.PDF)]assets = pdf_services.upload_assets(stream_assets)# Create parameters for the jobcombine_pdf_params = ((CombinePDFParams().add_asset(assets[0])).add_asset(assets[1]))# Creates a new job instancecombine_pdf_job = CombinePDFJob(combine_pdf_params=combine_pdf_params)# Submit the job and gets the job resultlocation = pdf_services.submit(combine_pdf_job)pdf_services_response = pdf_services.get_job_result(location, CombinePDFResult)# Get content from the resulting asset(s)result_asset: CombinePDFResult = pdf_services_response.get_result().get_asset()stream_asset: StreamAsset = pdf_services.get_content(result_asset)# Creates an output stream and copy stream asset's content to itoutput_file_path = 'output/CombinePDF.pdf'with open(output_file_path, "wb") as file:file.write(stream_asset.get_input_stream())except (ServiceApiException, ServiceUsageException, SdkException) as e:logging.exception(f'Exception encountered while executing operation: {e}')if __name__ == "__main__":CombinePDF()
Copied to your clipboard// Please refer our REST API docs for more information// https://developer.adobe.com/document-services/docs/apis/#tag/Combine-PDFcurl --location --request POST 'https://pdf-services.adobe.io/operation/combinepdf' \--header 'x-api-key: {{Placeholder for client_id}}' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer {{Placeholder for token}}' \--data-raw '{"assets": [{"assetID": "urn:aaid:AS:UE1:23c30ee0-2c4d-46d6-87f2-087832fca718"},{"assetID": "urn:aaid:AS:UE1:23c30ee0-2e4d-46d6-87f2-087832fca718"}]}'
Combine pages from multiple files
This combine sample combines specific pages from up to 20 different PDF files into a single PDF file. Optional arguments allow specifying page ranges for each file to combine in the output file.
Please refer the API usage guide to understand how to use our APIs.
Java
.NET
Node JS
Python
REST API
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_java_samples// Run the sample:// mvn -f pom.xml exec:java -Dexec.mainClass=com.adobe.pdfservices.operation.samples.combinepdf.CombinePDFWithPageRangespublic class CombinePDFWithPageRanges {// Initialize the logger.private static final Logger LOGGER = LoggerFactory.getLogger(CombinePDFWithPageRanges.class);public static void main(String[] args) {try (InputStream inputStream1 = Files.newInputStream(new File("src/main/resources/combineFileWithPageRangeInput1.pdf").toPath());InputStream inputStream2 = Files.newInputStream(new File("src/main/resources/combineFileWithPageRangeInput2.pdf").toPath())) {// Initial setup, create credentials instanceCredentials credentials = new ServicePrincipalCredentials(System.getenv("PDF_SERVICES_CLIENT_ID"),System.getenv("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadList<StreamAsset> streamAssets = new ArrayList<>();streamAssets.add(new StreamAsset(inputStream1, PDFServicesMediaType.PDF.getMediaType()));streamAssets.add(new StreamAsset(inputStream2, PDFServicesMediaType.PDF.getMediaType()));List<Asset> assets = pdfServices.uploadAssets(streamAssets);PageRanges pageRangesForFirstFile = getPageRangeForFirstFile();PageRanges pageRangesForSecondFile = getPageRangeForSecondFile();// Create parameters for the jobCombinePDFParams combinePDFParams = CombinePDFParams.combinePDFParamsBuilder().addAsset(assets.get(0), pageRangesForFirstFile) // Add the first asset as input to the params, along with its page ranges.addAsset(assets.get(1), pageRangesForSecondFile) // Add the second asset as input to the params, along with its page ranges.build();// Creates a new job instanceCombinePDFJob combinePDFJob = new CombinePDFJob(combinePDFParams);// Submit the job and gets the job resultString location = pdfServices.submit(combinePDFJob);PDFServicesResponse<CombinePDFResult> pdfServicesResponse = pdfServices.getJobResult(location, CombinePDFResult.class);// Get content from the resulting asset(s)Asset resultAsset = pdfServicesResponse.getResult().getAsset();StreamAsset streamAsset = pdfServices.getContent(resultAsset);// Creates an output stream and copy stream asset's content to itFiles.createDirectories(Paths.get("output/"));OutputStream outputStream = Files.newOutputStream(new File("output/combineFilesWithPageOptionsOutput.pdf").toPath());LOGGER.info("Saving asset at output/combineFilesWithPageOptionsOutput.pdf");IOUtils.copy(streamAsset.getInputStream(), outputStream);outputStream.close();} catch (ServiceApiException | IOException | SDKException | ServiceUsageException ex) {LOGGER.error("Exception encountered while executing operation", ex);}}private static PageRanges getPageRangeForSecondFile() {// Specify which pages of the second file are to be included in the combined filePageRanges pageRangesForSecondFile = new PageRanges();// Add all pages including and after page 3pageRangesForSecondFile.addAllFrom(3);return pageRangesForSecondFile;}private static PageRanges getPageRangeForFirstFile() {// Specify which pages of the first file are to be included in the combined filePageRanges pageRangesForFirstFile = new PageRanges();// Add page 1pageRangesForFirstFile.addSinglePage(1);// Add page 2pageRangesForFirstFile.addSinglePage(2);// Add pages 3 to 4pageRangesForFirstFile.addRange(3, 4);return pageRangesForFirstFile;}}
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_net_samples// Run the sample:// cd CombinePDFWithPageRanges/// dotnet run CombinePDFWithPageRanges.csprojnamespace CombinePDFWithPageRanges{class Program{private static readonly ILog log = LogManager.GetLogger(typeof(Program));static void Main(){//Configure the loggingConfigureLogging();try{// Initial setup, create credentials instanceICredentials credentials = new ServicePrincipalCredentials(Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_ID"),Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadusing Stream inputStream1 = File.OpenRead(@"combineFileWithPageRangeInput1.pdf");using Stream inputStream2 = File.OpenRead(@"combineFileWithPageRangeInput2.pdf");List<IAsset> assets = pdfServices.UploadAssets(new List<StreamAsset>(){new StreamAsset(inputStream1, PDFServicesMediaType.PDF.GetMIMETypeValue()),new StreamAsset(inputStream2, PDFServicesMediaType.PDF.GetMIMETypeValue())});PageRanges pageRangesForFirstFile = GetPageRangeForFirstFile();PageRanges pageRangesForSecondFile = GetPageRangeForSecondFile();// Create parameters for the jobCombinePDFParams combinePDFParams = CombinePDFParams.CombinePDFParamsBuilder().AddAsset(assets[0], pageRangesForFirstFile).AddAsset(assets[1], pageRangesForSecondFile).Build();// Creates a new job instanceCombinePDFJob combinePDFJob = new CombinePDFJob(combinePDFParams);// Submits the job and gets the job resultString location = pdfServices.Submit(combinePDFJob);PDFServicesResponse<CombinePDFResult> pdfServicesResponse =pdfServices.GetJobResult<CombinePDFResult>(location, typeof(CombinePDFResult));// Get content from the resulting asset(s)IAsset resultAsset = pdfServicesResponse.Result.Asset;StreamAsset streamAsset = pdfServices.GetContent(resultAsset);// Creating output streams and copying stream asset's content to itString outputFilePath = "/output/combineFilesOutput.pdf";new FileInfo(Directory.GetCurrentDirectory() + outputFilePath).Directory.Create();Stream outputStream = File.OpenWrite(Directory.GetCurrentDirectory() + outputFilePath);streamAsset.Stream.CopyTo(outputStream);outputStream.Close();}catch (ServiceUsageException ex){log.Error("Exception encountered while executing operation", ex);}catch (ServiceApiException ex){log.Error("Exception encountered while executing operation", ex);}catch (SDKException ex){log.Error("Exception encountered while executing operation", ex);}catch (IOException ex){log.Error("Exception encountered while executing operation", ex);}catch (Exception ex){log.Error("Exception encountered while executing operation", ex);}}private static PageRanges GetPageRangeForSecondFile(){// Specify which pages of the second file are to be included in the combined file.PageRanges pageRangesForSecondFile = new PageRanges();// Add all pages including and after page 5.pageRangesForSecondFile.AddAllFrom(5);return pageRangesForSecondFile;}private static PageRanges GetPageRangeForFirstFile(){// Specify which pages of the first file are to be included in the combined file.PageRanges pageRangesForFirstFile = new PageRanges();// Add page 2.pageRangesForFirstFile.AddSinglePage(2);// Add page 3.pageRangesForFirstFile.AddSinglePage(3);// Add pages 5 to 7.pageRangesForFirstFile.AddRange(5, 7);return pageRangesForFirstFile;}static void ConfigureLogging(){ILoggerRepository logRepository = LogManager.GetRepository(Assembly.GetEntryAssembly());XmlConfigurator.Configure(logRepository, new FileInfo("log4net.config"));}}}
Copied to your clipboard// Get the samples from http://www.adobe.com/go/pdftoolsapi_node_sample// Run the sample:// node src/combinepdf/combine-pdf-with-page-ranges.jsconst {ServicePrincipalCredentials,PDFServices,MimeType,CombinePDFParams,CombinePDFJob,CombinePDFResult,PageRanges,SDKError,ServiceUsageError,ServiceApiError} = require("@adobe/pdfservices-node-sdk");const fs = require("fs");(async () => {let readStream1;let readStream2;try {// Initial setup, create credentials instanceconst credentials = new ServicePrincipalCredentials({clientId: process.env.PDF_SERVICES_CLIENT_ID,clientSecret: process.env.PDF_SERVICES_CLIENT_SECRET});// Creates a PDF Services instanceconst pdfServices = new PDFServices({credentials});// Creates an asset(s) from source file(s) and uploadreadStream1 = fs.createReadStream("./combineFilesInput1.pdf");readStream2 = fs.createReadStream("./combineFilesInput2.pdf");const [inputAsset1, inputAsset2] = await pdfServices.uploadAssets({streamAssets: [{readStream: readStream1,mimeType: MimeType.PDF}, {readStream: readStream2,mimeType: MimeType.PDF}]});// Create a CombinePDFParams instanceconst params = new CombinePDFParams().addAsset(inputAsset1, getPageRangesForFirstFile()).addAsset(inputAsset2, getPageRangesForSecondFile());// Create a new job instanceconst job = new CombinePDFJob({params});// Submit the job and get the job resultconst pollingURL = await pdfServices.submit({job});const pdfServicesResponse = await pdfServices.getJobResult({pollingURL,resultType: CombinePDFResult});// Get content from the resulting asset(s)const resultAsset = pdfServicesResponse.result.asset;const streamAsset = await pdfServices.getContent({asset: resultAsset});// Creates an output stream and copy result asset's content to itconst outputFilePath = "./combineFilesOutput.pdf";console.log(`Saving asset at ${outputFilePath}`);const outputStream = fs.createWriteStream(outputFilePath);streamAsset.readStream.pipe(outputStream);} catch (err) {if (err instanceof SDKError || err instanceof ServiceUsageError || err instanceof ServiceApiError) {console.log("Exception encountered while executing operation", err);} else {console.log("Exception encountered while executing operation", err);}} finally {readStream1?.destroy();readStream2?.destroy();}})();const getPageRangesForFirstFile = () => {// Specify which pages of the first file are to be included in the combined file.const pageRangesForFirstFile = new PageRanges();// Add page 1.pageRangesForFirstFile.addSinglePage(1);// Add page 2.pageRangesForFirstFile.addSinglePage(2);// Add pages 3 to 4.pageRangesForFirstFile.addRange(3, 4);return pageRangesForFirstFile;};const getPageRangesForSecondFile = () => {// Specify which pages of the second file are to be included in the combined file.const pageRangesForSecondFile = new PageRanges();// Add all pages including and after page 3.pageRangesForSecondFile.addAllFrom(3);return pageRangesForSecondFile;};
Copied to your clipboard# Get the samples https://github.com/adobe/pdfservices-python-sdk-samples# Run the sample:# python src/combinepdf/combine_pdf_with_page_ranges.py# Initialize the loggerlogging.basicConfig(level=logging.INFO)class CombinePDFWithPageRanges:def __init__(self):try:file = open('./combineFilesInput1.pdf', 'rb')input_stream_1 = file.read()file.close()file = open('./combineFilesInput2.pdf', 'rb')input_stream_2 = file.read()file.close()# Initial setup, create credentials instancecredentials = ServicePrincipalCredentials(client_id=os.getenv('PDF_SERVICES_CLIENT_ID'),client_secret=os.getenv('PDF_SERVICES_CLIENT_SECRET'))# Creates a PDF Services instancepdf_services = PDFServices(credentials=credentials)# Creates an asset(s) from source file(s) and uploadstream_assets = [StreamAsset(input_stream_1, PDFServicesMediaType.PDF),StreamAsset(input_stream_2, PDFServicesMediaType.PDF)]assets = pdf_services.upload_assets(stream_assets)page_ranges_for_first_file = self.get_page_range_for_first_file()page_ranges_for_second_file = self.get_page_range_for_second_file()# Create parameters for the jobcombine_pdf_params = ((CombinePDFParams().add_asset(assets[0],page_ranges=page_ranges_for_first_file)).add_asset(assets[1],page_ranges=page_ranges_for_second_file))# Creates a new job instancecombine_pdf_job = CombinePDFJob(combine_pdf_params=combine_pdf_params)# Submit the job and gets the job resultlocation = pdf_services.submit(combine_pdf_job)pdf_services_response = pdf_services.get_job_result(location, CombinePDFResult)# Get content from the resulting asset(s)result_asset: CombinePDFResult = pdf_services_response.get_result().get_asset()stream_asset: StreamAsset = pdf_services.get_content(result_asset)# Creates an output stream and copy stream asset's content to itoutput_file_path = 'output/CombinePDFWithPageRanges.pdf'with open(output_file_path, "wb") as file:file.write(stream_asset.get_input_stream())except (ServiceApiException, ServiceUsageException, SdkException) as e:logging.exception(f'Exception encountered while executing operation: {e}')@staticmethoddef get_page_range_for_first_file() -> PageRanges:# Specify which pages of the first file are to be included in the combined filepage_ranges_for_first_file = PageRanges()# Add page 1page_ranges_for_first_file.add_single_page(1)# Add page 2page_ranges_for_first_file.add_single_page(2)# Add pages 3 to 4page_ranges_for_first_file.add_range(3, 4)return page_ranges_for_first_file@staticmethoddef get_page_range_for_second_file() -> PageRanges:# Specify which pages of the first file are to be included in the combined filepage_ranges_for_second_file = PageRanges()# Add all pages including and after page 3page_ranges_for_second_file.add_all_from(3)return page_ranges_for_second_fileif __name__ == "__main__":CombinePDFWithPageRanges()
Copied to your clipboard// Please refer our REST API docs for more information// https://developer.adobe.com/document-services/docs/apis/#tag/Combine-PDFcurl --location --request POST 'https://pdf-services.adobe.io/operation/combinepdf' \--header 'x-api-key: {{Placeholder for client_id}}' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer {{Placeholder for token}}' \--data-raw '{"assets": [{"assetID": "urn:aaid:AS:UE1:23c30ee0-2c4d-46d6-87f2-087832fca718","pageRanges": [{"start": 1,"end": 3}]},{"assetID": "urn:aaid:AS:UE1:23c30ee0-2e4d-46d6-87f2-087832fca718","pageRanges": [{"start": 2,"end": 4}]}]}'