curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs/11111111-1111-1111-1111-111111111111?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=50&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Pack retrieved",
"data": {
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 2,
"has_more": false,
"limit": 50,
"offset": 0,
"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",
"created_at": "2026-02-17T11:02:00.000Z",
"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",
"created_at": "2026-02-16T09:00:00.000Z",
"metadata": {
"status": "pending",
"description": null,
"keywords": [],
"model": "gpt-4.1-nano",
"generated_at": null,
"error": null
}
}
]
}
}
Packs
Get Pack
Retrieve pack metadata and a bounded ordered image page
GET
/
api
/
partner
/
v1
/
packs
/
{packId}
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs/11111111-1111-1111-1111-111111111111?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=50&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Pack retrieved",
"data": {
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 2,
"has_more": false,
"limit": 50,
"offset": 0,
"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",
"created_at": "2026-02-17T11:02:00.000Z",
"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",
"created_at": "2026-02-16T09:00:00.000Z",
"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.
Query Parameters
number
default:"50"
Number of newest-first images to return (
1-100).number
default:"0"
Number of matching images to skip.
image_count remains the exact full count.string
Inclusive ISO-8601 lower bound for image
created_at.string
Inclusive ISO-8601 upper bound for image
created_at. Must be at or after since.Path Parameters
string
required
Pack UUID.
Response
string
string
number
boolean
boolean
string
number
number
array
curl --request GET \
--url 'https://www.genviral.io/api/partner/v1/packs/11111111-1111-1111-1111-111111111111?since=2026-08-01T00%3A00%3A00.000Z&until=2026-08-31T23%3A59%3A59.999Z&limit=50&offset=0' \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Pack retrieved",
"data": {
"id": "11111111-1111-1111-1111-111111111111",
"name": "Motivation Pack",
"image_count": 2,
"has_more": false,
"limit": 50,
"offset": 0,
"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",
"created_at": "2026-02-17T11:02:00.000Z",
"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",
"created_at": "2026-02-16T09:00:00.000Z",
"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
