Merge Multiple Excel Files into a Single Workbook

This REST API merges multiple Excel files into a single Excel workbook.

REST API

POST https://api.aspose.cloud/v3.0/cells/merge

Request parameters

Parameter Name	Type	Location	Description	Required
files[]	file	formData	One or more Excel workbooks to be merged. Use `file1`, `file2`, … in the request.	Yes
format	string	query	Desired output format (e.g., `xlsx`).	Yes
mergeToOneSheet	boolean	query	Set to `true` to combine all worksheets into a single sheet; default is `false`.	No

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to make calls to the Cloud API with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/merge?format=xlsx" \
  -X POST \
  -H "Authorization: Bearer <jwt token>" \
  -F "file1=@file1.xlsx" \
  -F "file2=@file2.xlsx"

Response

{
  "Files": [
    {
      "Filename": "file1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "file2.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Explanation:

The response returns a JSON object containing the merged workbook(s) encoded in Base64.
Each entry in the Files array provides the original filename, its size, and the merged file content.

Error handling

HTTP Status	Meaning	Sample error body
400	Bad request – missing required files or parameters.	`{ "ErrorMessage": "File list cannot be empty.", "ErrorCode": "BadRequest" }`
401	Unauthorized – invalid or expired JWT token.	`{ "ErrorMessage": "Access token is invalid.", "ErrorCode": "Unauthorized" }`
415	Unsupported Media Type – file format not supported.	`{ "ErrorMessage": "Only Excel formats are allowed.", "ErrorCode": "UnsupportedMediaType" }`
500	Internal server error – unexpected failure on the server side.	`{ "ErrorMessage": "An unexpected error occurred.", "ErrorCode": "InternalError" }`

Cloud SDK Family

Using an SDK is the best way to speed up development. An SDK handles low‑level details so you can focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to call Aspose.Cells web services using various SDKs:

Merge an Excel Workbook into Another Workbook