Calculate a formula on an Excel worksheet – Aspose.Cells Cloud Documentation

This REST API returns the calculated value of a formula in a worksheet. It can be used to evaluate an Excel formula directly from your application.

REST API

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

Request parameters

Parameter Name	Type	Location	Description
name	string	path	Name of the Excel file.
sheetName	string	path	Name of the worksheet that contains the formula.
formula	string	query	The formula to be evaluated (e.g., `SUM(A5:A10)`).
folder	string	query	Folder where the document is stored.
storageName	string	query	Name of the storage service (if applicable).

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

Authentication

All requests must include a valid Bearer JWT token in the Authorization header:

Authorization: Bearer <your_jwt_token>

You can obtain a token by following the OAuth 2.0 flow described in the Aspose.Cells Cloud authentication guide.

Possible response status codes

Code	Description
200	Request succeeded; the formula value is returned.
400	Bad request – missing or invalid parameters.
401	Unauthorized – invalid or missing JWT token.
404	Not found – the specified file or worksheet does not exist.
500	Internal server error – unexpected condition on the server.

You can use the cURL command‑line tool to call Aspose.Cells Cloud web services easily. The example below shows how to request a formula result with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet2/formulaResult?formula=SUM(A5:A10)" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Response

{
  "Value": {
    "Value": "0"
  },
  "Code": "200",
  "Status": "OK"
}

Cloud SDK Family

Using an SDK is the fastest way to integrate 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 using various SDKs:

See also: