> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Slideshows

> List slideshow summaries in authenticated key scope

Returns paginated slideshow summaries for the authenticated workspace/personal scope.

## Query Parameters

<ParamField query="status" type="string">
  Optional status filter (for example `draft` or `rendered`).
</ParamField>

<ParamField query="search" type="string">
  Optional title search (case-insensitive partial match).
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of records to return. Range: `1-100`.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of records to skip.
</ParamField>

## Response

<ResponseField name="slideshows" type="array">
  Slideshow summary list.

  <Expandable title="Summary Object">
    <ResponseField name="id" type="string" />

    <ResponseField name="title" type="string" />

    <ResponseField name="status" type="string" />

    <ResponseField name="slideshow_type" type="string" />

    <ResponseField name="product_id" type="string | null" />

    <ResponseField name="preview_image_url" type="string | null" />

    <ResponseField name="slide_count" type="number" />

    <ResponseField name="has_rendered_slide" type="boolean" />

    <ResponseField name="created_at" type="string" />

    <ResponseField name="updated_at" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total matching rows before pagination.
</ResponseField>

<ResponseField name="limit" type="number" />

<ResponseField name="offset" type="number" />

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&limit=20&offset=0' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Slideshows retrieved",
    "data": {
      "slideshows": [
        {
          "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
          "title": "5 discipline quotes",
          "status": "draft",
          "slideshow_type": "educational",
          "product_id": null,
          "preview_image_url": null,
          "slide_count": 5,
          "has_rendered_slide": false,
          "created_at": "2026-02-14T09:20:00.000Z",
          "updated_at": "2026-02-14T09:20:00.000Z"
        }
      ],
      "total": 1,
      "limit": 20,
      "offset": 0
    }
  }
  ```
</ResponseExample>

## Error Responses

* `422 invalid_query` - query params failed validation
* `401` - authentication failed (missing/invalid/revoked token)
* `402 subscription_required` - active Creator/Professional/Business plan required
* `403 tier_not_allowed` - Scheduler tier cannot use Partner API
* `500 slideshows_list_failed` - unexpected listing failure