Skip to main content
GET
/
api
/
partner
/
v1
/
packs
/
{packId}
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/packs/11111111-1111-1111-1111-111111111111 \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Pack retrieved",
  "data": {
    "id": "11111111-1111-1111-1111-111111111111",
    "name": "Motivation Pack",
    "image_count": 2,
    "is_public": false,
    "created_at": "2026-02-14T09:00:00.000Z",
    "images": [
      {
        "id": "22222222-2222-2222-2222-222222222222",
        "url": "https://cdn.example.com/packs/motivation/01.jpg",
        "metadata": {
          "status": "completed",
          "description": "Woman lifting dumbbells in a bright, minimal gym environment.",
          "keywords": ["fitness", "workout", "strength", "gym", "motivation", "healthy lifestyle"],
          "model": "gpt-4.1-nano",
          "generated_at": "2026-02-17T11:02:00.000Z",
          "error": null
        }
      },
      {
        "id": "33333333-3333-3333-3333-333333333333",
        "url": "https://cdn.example.com/packs/motivation/02.jpg",
        "metadata": {
          "status": "pending",
          "description": null,
          "keywords": [],
          "model": "gpt-4.1-nano",
          "generated_at": null,
          "error": null
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.genviral.io/llms.txt

Use this file to discover all available pages before exploring further.

Fetches one pack visible to the authenticated key scope.

Path Parameters

packId
string
required
Pack UUID.

Response

id
string
name
string
image_count
number
is_public
boolean
created_at
string
images
array
Ordered by created_at ascending.
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/packs/11111111-1111-1111-1111-111111111111 \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "code": 200,
  "message": "Pack retrieved",
  "data": {
    "id": "11111111-1111-1111-1111-111111111111",
    "name": "Motivation Pack",
    "image_count": 2,
    "is_public": false,
    "created_at": "2026-02-14T09:00:00.000Z",
    "images": [
      {
        "id": "22222222-2222-2222-2222-222222222222",
        "url": "https://cdn.example.com/packs/motivation/01.jpg",
        "metadata": {
          "status": "completed",
          "description": "Woman lifting dumbbells in a bright, minimal gym environment.",
          "keywords": ["fitness", "workout", "strength", "gym", "motivation", "healthy lifestyle"],
          "model": "gpt-4.1-nano",
          "generated_at": "2026-02-17T11:02:00.000Z",
          "error": null
        }
      },
      {
        "id": "33333333-3333-3333-3333-333333333333",
        "url": "https://cdn.example.com/packs/motivation/02.jpg",
        "metadata": {
          "status": "pending",
          "description": null,
          "keywords": [],
          "model": "gpt-4.1-nano",
          "generated_at": null,
          "error": null
        }
      }
    ]
  }
}

Error Responses

  • 400 missing_pack_id - path param missing
  • 404 not_found - pack is missing/outside key scope
  • 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 pack_get_failed - unexpected retrieval failure