# Get a slideshow

> Get a slideshow with the Wavegrain Carousel API: GET /api/v1/slideshows/{id}. Parameters, responses and an example request.

> Index of these docs: https://wavegrain.com/developers/llms.txt

`GET /api/v1/slideshows/{id}` is part of the [Carousel API](/developers/carousel-api). Every call needs an access key: see [Authentication](/developers/authentication).

Needs the `read` permission. One slideshow with every slide's image and words, its caption, its approval and, for a tailored one, its preview sheet: one shape for both kinds.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

## Example request

```bash
curl https://wavegrain.com/api/v1/slideshows/ID \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The slideshow. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 404 | No such slideshow of yours. |
| 429 | Too many requests for the key or the account |
| 500 | Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing. |

A successful answer:

```json
{
  "id": "ses_Ry4kP2",
  "kind": "canvas",
  "title": "Three ways to keep rice fluffy",
  "topic": "Three ways to keep rice fluffy",
  "status": "editing",
  "reviewState": "draft",
  "caption": "Three ways to keep rice fluffy. Save this for later.",
  "scheduledFor": null,
  "link": "https://wavegrain.com/editor/ses_Ry4kP2",
  "sheetUrl": null,
  "slides": [
    {
      "number": 1,
      "imageUrl": "https://wavegrain.com/media/slides/ses_Ry4kP2/1.jpg",
      "text": [
        "Fluffy rice, every time",
        "Three steps that work"
      ]
    }
  ]
}
```

## More in the Carousel API

- [Estimate a slideshow's price](/developers/api/estimate-slideshow): `POST /api/v1/slideshows/estimate`
- [Make a slideshow from a topic](/developers/api/create-slideshow): `POST /api/v1/slideshows`
- [List slideshows](/developers/api/list-slideshows): `GET /api/v1/slideshows`
- [Make a slideshow in a post's look](/developers/api/copy-post): `POST /api/v1/slideshows/copies`
- [Follow a slideshow job](/developers/api/get-job): `GET /api/v1/jobs/{id}`
- [Download a slideshow](/developers/api/export-slideshow): `POST /api/v1/slideshows/{id}/export`
- [All endpoints](/developers/api)
