> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Sheet Range

Read data from a specific range in a Lark Sheets spreadsheet.

One of the following scopes is required for using this action:

* `View, comment, edit, and manage all files in My Space`
* `View, comment, and download all files in My Space`
* `View, comment, edit, and manage Sheets`
* `View, comment, and export Sheets`

<Note>
  External Documentation

  To learn more, visit the [Lark documentation](https://open.larksuite.com/document/server-docs/docs/sheets-v3/data-operation/reading-a-single-range).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                                                                                                                                                                                                                                                     |
  | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Range             | The cell range to read from the spreadsheet.<br /><br />Examples:<br />\* `A1:C10` - Read cells from A1 to C10.<br />\* `A:A` - Read entire column A.<br /><br />For more information about the range parameter, visit [Lark API documentation](https://open.larksuite.com/document/server-docs/docs/sheets-v3/guide/overview). |
  | Sheet ID          | The ID of the sheet to get the range from.<br /><br />Use the `Get Spreadsheet Metadata` action to retrieve available sheet IDs.                                                                                                                                                                                                |
  | Spreadsheet Token | The token of the spreadsheet.<br /><br />This token can be found in the spreadsheet URL - `https://sample.larksuite.com/sheets/{SPREADSHEET_TOKEN}`.<br /><br />For example, if the sheet URL is `https://sample.larksuite.com/sheets/shtcnmBA*yGehy8`, the token is: `shtcnmBA*yGehy8`.                                        |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter               | Description                                |
  | ----------------------- | ------------------------------------------ |
  | Date Time Render Option | How to render date and time values.        |
  | Value Render Option     | How to render cell values in the response. |
</div>

## Example Output

```json theme={"dark"}
{
	"code": 0,
	"data": {
		"revision": 0,
		"spreadsheetToken": "***",
		"valueRange": {
			"majorDimension": "ROWS",
			"range": "***",
			"revision": 0,
			"values": [
				[
					"***"
				]
			]
		}
	},
	"msg": "Success"
}
```

## Workflow Library Example

[Get Sheet Range with Lark and Send Results Via Email](https://library.blinkops.com/workflows/get-sheet-range-with-lark-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-sheet-range-with-lark-and-send-results-via-email/canvas" />
</div>