Get a worksheet validation by index from an Excel worksheet

This REST API retrieves a worksheet validation by its index on an Excel worksheet.
Before calling the endpoint, obtain a JWT token via the /connect/token endpoint and include it in the Authorization header as Bearer <jwt token>.

REST API

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

Request parameters

Parameter Name	Type	Location	Description
name	string	path	The name of the workbook file.
sheetName	string	path	The name of the worksheet.
validationIndex	integer	path	Zero‑based index of the validation to retrieve.
folder	string	query	Folder that contains the workbook.
storageName	string	query	Name of the storage service.

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 call the API with cURL.

Request

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

Response

{
  "Validation": {
    "AlertStyle": "Stop",
    "AreaList": [
      {
        "EndColumn": 0,
        "EndRow": 0,
        "StartColumn": 0,
        "StartRow": 0
      },
      {
        "EndColumn": 27,
        "EndRow": 0,
        "StartColumn": 26,
        "StartRow": 0
      }
    ],
    "IgnoreBlank": false,
    "InCellDropDown": false,
    "Operator": "None",
    "ShowError": false,
    "ShowInput": false,
    "Type": "AnyValue",
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/myWorkBook.xlsx/worksheets/Sheet1/Validations/0",
      "Rel": "self"
    }
  },
  "Code": "200",
  "Status": "OK"
}

Response schema

Field	Type	Description
AlertStyle	string	The style of the alert shown to the user (Stop, Warning, Information).
AreaList	array	Collection of cell ranges that the validation applies to.
IgnoreBlank	boolean	If `true`, blank cells are ignored during validation.
InCellDropDown	boolean	If `true`, a drop‑down list is displayed in the cell.
Operator	string	Comparison operator used for the validation (e.g., `None`, `Between`).
ShowError	boolean	Determines whether an error message is shown when validation fails.
ShowInput	boolean	Determines whether an input message is shown when the cell is selected.
Type	string	Type of validation (e.g., `AnyValue`, `WholeNumber`, `Decimal`, etc.).
link.Href	string	Self‑reference URL to the validation resource.
link.Rel	string	Relation type (always `self`).

Possible error codes

HTTP Status	Meaning
200	Validation retrieved successfully.
400	Bad request – missing or invalid parameters.
401	Unauthorized – invalid or missing JWT token.
404	Not found – workbook, worksheet, or validation index does not exist.
500	Internal server error – unexpected condition.

Cloud SDK Family

Using an SDK is the fastest way to develop against Aspose.Cells Cloud. An SDK abstracts low‑level details so you can focus on your business logic. Check 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: