List slideshows

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

GET /api/v1/slideshows is part of the Carousel API. Every call needs an access key: see Authentication.

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

Parameters

NameInTypeRequiredNotes
limitqueryintegernoSlideshows per page, 1 to 50.
cursorquerystringnoThe nextCursor of the page before.

Example request

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

Responses

StatusMeaning
200A page of slideshows.
400A query parameter is not valid.
401No access key, or an unknown, revoked or expired one
403The key lacks the permission, or the account has no active plan
429Too many requests for the key or the account
500Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing.

A successful answer:

{
  "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
}

Something wrong or missing? Write to support@wavegrain.com.