---
title: "Get deck"
method: GET
path: "/v1/decks/{id}"
tags: ["Browse decks"]
---

# Get deck

`GET /v1/decks/{id}`

## Request

- Base URL: `https://api.slides.com`
- URL: `https://api.slides.com/v1/decks/{id}`
- 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 details for an owned deck.

## Path parameters

- `id` union, required
  - string
  - integer

## Query parameters

- `include_deck_html` boolean: Include the complete deck HTML as deck_html.

## Response `200`

Returns deck details. Read speaker notes through the slide APIs. deck_html is present only when include_deck_html is true.

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

## Other responses

- `401`: A valid API key or OAuth access token is required.
- `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)