Skip to main content
GET
/
api
/
partner
/
v1
/
slideshows
curl --request GET \
  --url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&limit=20&offset=0' \
  --header 'Authorization: Bearer <token>'

{
  "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
  }
}
Returns paginated slideshow summaries for the authenticated workspace/personal scope.

​
Query Parameters

​
status
string
Optional status filter (for example draft or rendered).
​
search
string
Optional title search (case-insensitive partial match).
​
limit
number
default:"20"
Number of records to return. Range: 1-100.
​
offset
number
default:"0"
Number of records to skip.

​
Response

​
slideshows
array
Slideshow summary list.
​
total
number
Total matching rows before pagination.
​
limit
number
​
offset
number
curl --request GET \
  --url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&limit=20&offset=0' \
  --header 'Authorization: Bearer <token>'

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

​
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