---
title: "List deck shares"
method: GET
path: "/v1/decks/{deck_id}/share"
tags: ["Sharing"]
---

# List deck shares

`GET /v1/decks/{deck_id}/share`

## Request

- Base URL: `https://api.slides.com`
- URL: `https://api.slides.com/v1/decks/{deck_id}/share`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://slides.com/oauth/authorize`, token URL `https://slides.com/oauth/token`, scopes: `read`)

Returns all private share links for an owned deck, ordered newest first.

## Path parameters

- `deck_id` union, required
  - string
  - integer

## Response `200`

Private share links are returned in data; meta contains total. Each link includes default and fullscreen URLs.

- ApiResponse
  - `data` unknown, required
  - `meta` object

## Other responses

- `401`: A valid API key or OAuth access token is required.
- `403`: The credential or account cannot perform this operation.
- `404`: The requested resource was not found.
- `422`: The request parameters or body are invalid.
- `429`: The request rate limit was exceeded.

---

[API](https://skmtc.dev/slides/apis/slides-rest-api.md) · [All operations](https://skmtc.dev/slides/apis/slides-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slides/apis/slides-rest-api/revisions/7d5a371a6715?raw)