Export a Worksheet Page – Aspose.Cells Cloud API Reference

Exporting a specific worksheet page is useful when you need a printable snapshot of a report, a chart image, or a data extract without downloading the entire workbook. This endpoint lets you retrieve a single page in the format that best fits your downstream workflow.

GET /cells/{name}/worksheets/{sheetName} API lets you convert a specified page of a worksheet to various file formats. Supported formats: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.

REST API

The OpenAPI Specification defines a publicly accessible programming interface and enables you to perform REST interactions directly from a web browser.

Prerequisites – You must have a valid JWT authentication token and the workbook stored in a cloud folder that you specify with the folder parameter.

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

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1?format=png&verticalResolution=100&horizontalResolution=90&pageIndex=1&folder=DotnetFiles" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

Response – The service returns the requested page in the chosen format. For image formats (png, jpeg, gif, etc.) the body contains the binary image; for document formats (pdf, xls, csv, …) the body contains the file content. A successful call returns HTTP 200.

Example of a PNG response (truncated base64 snippet):

iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABG0lEQVR42mNkYGBg+M+ABbJw
...

Parameters

Parameter	Type	Description	Default
`format`	string	Output file format (e.g., `pdf`, `png`, `csv`).	`pdf`
`verticalResolution`	integer	Vertical DPI of the rendered image.	`100`
`horizontalResolution`	integer	Horizontal DPI of the rendered image.	`100`
`pageIndex`	integer	Zero‑based index of the worksheet page to export (`0` = first page).	`0`
`folder`	string	Cloud storage folder where the source workbook resides.	—

Status Codes

Code	Meaning
200	Success – file returned in the body
202	Accepted – request is being processed
401	Unauthorized – invalid or missing JWT
404	Not Found – workbook or worksheet missing
400	Bad Request – invalid parameter value
500	Internal Server Error – unexpected issue

Possible errors

401 Unauthorized – Invalid or missing JWT token.
404 Not Found – Specified workbook or worksheet does not exist.
400 Bad Request – Invalid parameter value (e.g., unsupported format).
500 Internal Server Error – Unexpected server‑side problem.

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:

Export a Worksheet Area to PNG, PDF, CSV – Aspose.Cells Cloud API