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,
"aspect_ratio": "9:16",
"cover_slide": {
"image_url": "https://cdn.vireel.io/slideshow/images/discipline-0.jpg",
"rendered_image_url": null,
"text_elements": [
{
"content": "5 quotes that rewired my discipline",
"x": 50,
"y": 30,
"width": 80,
"height": null,
"font_size": 54,
"style_preset": "tiktok",
"font_family": null,
"text_color": null,
"background_color": null,
"border_radius": null
}
]
},
"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,
"aspect_ratio": "9:16",
"cover_slide": {
"image_url": "https://cdn.vireel.io/slideshow/images/discipline-0.jpg",
"rendered_image_url": null,
"text_elements": [
{
"content": "5 quotes that rewired my discipline",
"x": 50,
"y": 30,
"width": 80,
"height": null,
"font_size": 54,
"style_preset": "tiktok",
"font_family": null,
"text_color": null,
"background_color": null,
"border_radius": null
}
]
},
"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
Slideshow summary list.
Show Summary Object
Show Summary Object
string
string
string
string
string | null
string | null
number
boolean
string
The deck’s slide ratio:
9:16, 3:4, 4:5, or 1:1 (9:16 when none is set).object | null
The first slide, so a list can draw each cover like the editor;
null for a deck with
no slides.Show Cover Slide Object
Show Cover Slide Object
string | null
Background image.
string | null
Rendered slide with the text baked in;
null until the deck is rendered (and again
after an edit).array
Text drawn on the background:
content, x and y (box centre, percent of the
slide), width, height (percent), font_size (1080px-canvas pixels),
style_preset, font_family, text_color, background_color, border_radius.
Unset style fields are null.string
string
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,
"aspect_ratio": "9:16",
"cover_slide": {
"image_url": "https://cdn.vireel.io/slideshow/images/discipline-0.jpg",
"rendered_image_url": null,
"text_elements": [
{
"content": "5 quotes that rewired my discipline",
"x": 50,
"y": 30,
"width": 80,
"height": null,
"font_size": 54,
"style_preset": "tiktok",
"font_family": null,
"text_color": null,
"background_color": null,
"border_radius": null
}
]
},
"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