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
}
}
]
}
}
Packs
Get Pack
Retrieve pack metadata and ordered image list
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
Pack UUID.
Response
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 missing404 not_found- pack is missing/outside key scope401- authentication failed (missing/invalid/revoked token)402 subscription_required- active Creator/Professional/Business plan required403 tier_not_allowed- Scheduler tier cannot use Partner API500 pack_get_failed- unexpected retrieval failure
⌘I
