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
        }
      }
    ]
  }
}
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