---
title: "List sheets"
method: GET
path: "/sheets"
tags: ["sheets"]
---

# List sheets

`GET /sheets`

Gets a list of all sheets that the user has access to. The list contains an abbreviated Sheet object for each sheet.

> **Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

## Query parameters

- `include` 'sheetVersion' | 'source'
- `includeAll` boolean
- `modifiedSince` union
  - string, date-time
  - number
- `numericDates` boolean
- `page` number
- `pageSize` number

## Response `200`

SUCCESS.

**Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

- object
  - `pageNumber` number — The current page in the full result set that the data array represents. NOTE when a page number greater than totalPages is requested, the last page is instead returned.
  - `pageSize` number, nullable — The number of items in a page. Omitted if there is no limit to page size (and hence, all results are included). Unless otherwise specified, this defaults to 100 for most endpoints.
  - `totalPages` number — The total number of pages in the full result set.
  - `totalCount` number — The total number of items in the full result set.
  - `data` SchemasSheet[]
    - `id` number — Sheet ID.
    - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER'
    - `createdAt` union
      - string, date-time
      - number
    - `modifiedAt` union
      - string, date-time
      - number
    - `name` string — Sheet name.
    - `permalink` string — URL that represents a direct link to the sheet in Smartsheet.
    - `version` number — A number that is incremented every time a sheet is modified.
    - `source` Source
      - `id` number — The ID of the dashboard, report, sheet, or template from which the enclosing dashboard, report, sheet, or template was created.
      - `type` string — **report**, **sheet**, **sight** (aka dashboard), or **template**.

## Other responses

- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/revisions/b4afda95fb51/schema)