# List slideshows

> List slideshows with the Wavegrain Carousel API: GET /api/v1/slideshows. Parameters, responses and an example request.

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

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

Needs the `read` permission. Your slideshows, newest first, made any way: in Wavegrain, by an agent or through this API.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | Slideshows per page, 1 to 50. |
| `cursor` | query | string | no | The `nextCursor` of the page before. |

## Example request

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

## Responses

| Status | Meaning |
| --- | --- |
| 200 | A page of slideshows. |
| 400 | A query parameter is not valid. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 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
{
  "slideshows": [
    {
      "id": "ses_Ry4kP2",
      "kind": "canvas",
      "title": "Three ways to keep rice fluffy",
      "status": "editing",
      "reviewState": "draft",
      "slideCount": 6,
      "scheduledFor": null,
      "createdAt": "2026-11-12T10:00:00.000Z",
      "link": "https://wavegrain.com/editor/ses_Ry4kP2"
    }
  ],
  "nextCursor": null
}
```

## 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`
- [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}`
- [Get a slideshow](/developers/api/get-slideshow): `GET /api/v1/slideshows/{id}`
- [Download a slideshow](/developers/api/export-slideshow): `POST /api/v1/slideshows/{id}/export`
- [All endpoints](/developers/api)
