---
title: "Get asset share"
method: GET
path: "/shares/{shareId}"
tags: ["sharing"]
---

# Get asset share

`GET /shares/{shareId}`

Retrieves a specific share for the specified asset.

## Path parameters

- `shareId` string, required

## Query parameters

- `assetType` 'sheet' | 'report' | 'sight' | 'workspace' | 'collection' | 'file', required
- `assetId` string, required

## Response `200`

The share specified by the shareId.

- 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)