Get Merged Cells from an Excel Worksheet – Aspose.Cells Cloud API

This REST API returns information about merged cells in an Excel worksheet.

Note – The API object is called MergedCell (singular). In the prose we refer to the concept of merged cells (plural).

REST API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/mergedCells

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request parameters

Parameter Name	Type	Location	Description
name	string	path	The Excel file name.
sheetName	string	path	The worksheet name.
folder	string	query	Folder that contains the document.
storageName	string	query	Name of the storage to use.

Response

Return MergedCellsResponse.

{
  "Status":"OK",
  "Code":200,
  "MergedCells":{
    "Count": 0,
    "MergedCellList":[
      {
        "Link":{
          "Href":"",
          "Rel":"",
          "Type":"",
          "Title":""
        }
      }
    ]
  }
}

Http Status Codes

Code	Meaning	Description
200	OK	Compression succeeded; response contains compressed file details.
400	Bad Request	Missing or invalid parameters (e.g., unsupported file type).
401	Unauthorized	Invalid or missing JWT token.
413	Payload Too Large	Uploaded file exceeds size limit.
500	Internal Server Error	Unexpected server error.

How to Use the GetWorksheetMergedCells API with SDKs

GetWorksheetMergedCells API Specification

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 example below shows how to make a call to the Cloud API with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/mergedCells" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "MergedCells": {
    "Count": 1,
    "MergedCells": [
      {
      "link": {
            "Href": "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/cells/mergedcells/0",
            "Rel": "self"
          }
      }
    ]    
  },
  "Code": "200",
  "Status": "OK"
}

Use Aspose.Cells Cloud SDKs

Using an SDK is the fastest way to develop against the API. An SDK handles low‑level details so you can focus on your business logic. See the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

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

Clear Contents and Styles of Cells in an Excel Worksheet Set Cell Value – Aspose.Cells Cloud API Reference (v3.0)