> ## 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.

# List Packs

> List visible packs with pagination and optional public-pack inclusion

Returns pack summaries visible to the authenticated key scope.

## Query Parameters

<ParamField query="search" type="string">
  Optional case-insensitive filter across pack name and AI image metadata
  (description + keywords).
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of packs to return. Range: `1-100`.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of packs to skip.
</ParamField>

<ParamField query="include_public" type="boolean" default="true">
  Include public packs in addition to scope-owned packs.
</ParamField>

<Note>
  `include_public` only accepts literal query values `true` or `false`.
  Any other value falls back to default behavior (`true`).
</Note>

## Response

<ResponseField name="packs" type="array">
  Pack summary list.

  <Expandable title="Pack Summary Object">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="image_count" type="number" />

    <ResponseField name="preview_image_url" type="string | null" />

    <ResponseField name="is_public" type="boolean" />

    <ResponseField name="created_at" type="string" />
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number" />

<ResponseField name="limit" type="number" />

<ResponseField name="offset" type="number" />

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://www.genviral.io/api/partner/v1/packs?search=motivation&include_public=false&limit=20' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>

## 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