curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs?search=motivation&include_public=false&limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Packs retrieved",
"data": {
"packs": [
{
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 24,
"preview_image_url": "https://cdn.example.com/packs/motivation/cover.jpg",
"is_public": false,
"created_at": "2026-02-14T09:00:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
}
Packs
List Packs
List visible packs with pagination and optional public-pack inclusion
GET
/
api
/
partner
/
v1
/
packs
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs?search=motivation&include_public=false&limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Packs retrieved",
"data": {
"packs": [
{
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 24,
"preview_image_url": "https://cdn.example.com/packs/motivation/cover.jpg",
"is_public": false,
"created_at": "2026-02-14T09:00:00.000Z"
}
],
"total": 1,
"limit": 20,
"offset": 0
}
}
Returns pack summaries visible to the authenticated key scope.
Packs are globally ordered newest-created first across owned and public results.
Query Parameters
string
Inclusive ISO-8601 lower bound on
created_at.string
Inclusive ISO-8601 upper bound on
created_at.string
Optional case-insensitive filter across pack name and AI image metadata
(description + keywords).
number
default:"20"
Number of packs to return. Range:
1-100.number
default:"0"
Number of packs to skip.
boolean
default:"true"
Include public packs in addition to scope-owned packs.
include_public only accepts literal query values true or false.
Any other value falls back to default behavior (true).Response
number
number
number
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs?search=motivation&include_public=false&limit=20' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Packs retrieved",
"data": {
"packs": [
{
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 24,
"preview_image_url": "https://cdn.example.com/packs/motivation/cover.jpg",
"is_public": false,
"created_at": "2026-02-14T09:00: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 packs_list_failed- unexpected listing failure