---
title: "List asset shares"
method: GET
path: "/shares"
tags: ["sharing"]
---

# List asset shares

`GET /shares`

Retrieves a list of all users and groups to whom the specified asset is shared, and their access level. This operation supports query string parameters for pagination of results. 

> **Note:** For pagination guidance, refer to [Token-based pagination](/api/smartsheet/guides/basics/pagination#token-based-pagination).

## Query parameters

- `assetType` 'sheet' | 'report' | 'sight' | 'workspace' | 'collection' | 'file', required
- `assetId` string, required
- `maxItems` integer
- `lastKey` string
- `sharingInclude` 'ITEM' | 'WORKSPACE'

## Response `200`

Object containing an array of [Share response](/api/smartsheet/openapi/sharing/shareresponse) objects. By default, this operation returns only item-level shares 
(scope=ITEM). Use the sharingInclude parameter to request that workspace level shares also be returned.

The response result will always exist, but the list may be empty if there are no shares for the specified asset.

- object
  - `lastKey` string — A token that is used to retrieve the next page of results when passed as the `lastKey` query parameter. This value will be absent when there are no further pages.
  - `items` ShareResponse[]
    - `id` string, required — The ID of the share.
    - `email` string — User's primary email address for user shares.
    - `userId` number — User ID if the share is a user share.
    - `groupId` number — Group ID if the share is a group share.
    - `name` string — If present, the name of the user or group to which the asset is shared.
    - `type` string, required — The type of this share. One of the following values: GROUP or USER.
    - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER', required
    - `scope` 'ITEM' | 'WORKSPACE', required — The scope of this share. One of the following values: * **ITEM**: an item-level share (that is, the specific object to which the share applies is shared with the user or group). * **WORKSPACE**: a workspace-level share (that is, the workspace that contains the asset to which the share applies is shared with the user or group).

## 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/versions/b4afda95fb51/schema)