curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&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
}
}
Slideshows
List Slideshows
List slideshow summaries in authenticated key scope
GET
/
api
/
partner
/
v1
/
slideshows
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&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.
Results are ordered by
created_at descending, with the slideshow ID as a stable
tie-breaker, so the newest-created slideshow is always returned first.
Query Parameters
string
Optional status filter (for example
draft or rendered).string
Optional title search (case-insensitive partial match).
number
default:"20"
Number of records to return. Range:
1-100.number
default:"0"
Number of records to skip.
string
Inclusive ISO 8601 lower bound on
created_at (for example,
2026-08-01T00:00:00.000Z).string
Inclusive ISO 8601 upper bound on
created_at. When both bounds are supplied,
until must be at or after since.Response
array
number
Total matching rows before pagination.
number
number
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/slideshows?status=draft&since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&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 validation401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API500 slideshows_list_failed- unexpected listing failure