Skip to main content
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.

​
Query Parameters

​
search
string
Optional case-insensitive filter across pack name and AI image metadata (description + keywords).
​
limit
number
default:"20"
Number of packs to return. Range: 1-100.
​
offset
number
default:"0"
Number of packs to skip.
​
include_public
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

​
packs
array
Pack summary list.
​
total
number
​
limit
number
​
offset
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 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 packs_list_failed - unexpected listing failure