> ## 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.

# Get Slideshow

> Retrieve a full slideshow payload

Fetch one slideshow, including settings and slide-level content.

## Path Parameters

<ParamField path="slideshowId" type="string" required>
  Slideshow UUID.
</ParamField>

## Response

<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="original_prompt" type="string | null" />

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

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

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

<ResponseField name="settings" type="object | null">
  Slideshow-level settings.

  <Expandable title="Settings Object">
    <ResponseField name="image_pack_id" type="string | null" />

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

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

    <ResponseField name="advanced_settings" type="object | null" />

    <ResponseField name="pack_assignments" type="object | null" />
  </Expandable>
</ResponseField>

<ResponseField name="slides" type="array">
  Ordered slide list.

  <Expandable title="Slide Object">
    <ResponseField name="index" type="number" />

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

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

    <ResponseField name="text_elements" type="array" />

    <ResponseField name="grid_images" type="string[] | null" />

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

    <ResponseField name="background_filters" type="object | null" />

    <ResponseField name="image_overlays" type="array | null" />
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://www.genviral.io/api/partner/v1/slideshows/2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Slideshow retrieved",
    "data": {
      "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
      "title": "5 discipline quotes",
      "status": "draft",
      "slideshow_type": "educational",
      "product_id": null,
      "original_prompt": "5 discipline quotes",
      "preview_image_url": null,
      "created_at": "2026-02-14T09:20:00.000Z",
      "updated_at": "2026-02-14T09:20:00.000Z",
      "last_rendered_at": null,
      "slide_count": 1,
      "settings": {
        "image_pack_id": "11111111-1111-1111-1111-111111111111",
        "aspect_ratio": "4:5",
        "slideshow_type": "educational",
        "advanced_settings": {
          "font_size": 44,
          "text_preset": "tiktok",
          "text_width": "default"
        },
        "pack_assignments": null
      },
      "slides": [
        {
          "index": 0,
          "image_url": "https://cdn.example.com/slide-1.jpg",
          "rendered_image_url": null,
          "text_elements": [
            {
              "id": "9fd0b2bd-a95a-4488-8b7a-bf1d18d2bcdf",
              "content": "Discipline beats motivation",
              "x": 50,
              "y": 25,
              "font_size": 48,
              "width": 70,
              "height": null,
              "editable": true,
              "style_preset": "tiktok",
              "font_family": null,
              "background_color": null,
              "text_color": null,
              "border_radius": null
            }
          ],
          "grid_images": null,
          "grid_type": null,
          "background_filters": null,
          "image_overlays": null
        }
      ]
    }
  }
  ```
</ResponseExample>

## Error Responses

* `400 missing_slideshow_id` - path param missing
* `404 not_found` - slideshow is missing or outside key scope
* `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 get_failed` - unexpected retrieval failure