---
title: "List versioned public brand kits"
method: GET
path: "/agent/brand-kits"
---

# List versioned public brand kits

`GET /agent/brand-kits`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agent/brand-kits`
- Auth: HTTP bearer

Returns exact positive-projection brand packs and brand-kit projects/pages for server-authorized creator spaces.

## Query parameters

- `creator_id` string
- `limit` integer

## Response `200`

Versioned public brand-kit list

- AgentBrandKitListOperationResponse
  - `schema` 'bamf.operation-result/v1', required
  - `operation_ref` 'bamf.brand_kits.list/v1', required
  - `data` AgentBrandKitListData, required
    - `creators` AgentBrandKitCollection[], required
      - `creator_id` string, required
      - `brand_packs` AgentBrandPack[], required
        - `id` string, required
        - `creator_id` string, required
        - `pack_type` string, nullable, required
        - `name` string, nullable, required
        - `description` string, nullable, required
        - `is_default` boolean, required
        - `tags` unknown, required
        - `palette` unknown, required
        - `fonts` unknown, required
        - `visual_style_prompt` string, nullable, required
        - `brand_rules` string, nullable, required
        - `notes` string, nullable, required
        - `negative_prompt` string, nullable, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
        - `assets` AgentBrandPackAsset[], required
          - `id` string, required
          - `brand_pack_id` string, required
          - `media_asset_id` string, nullable, required
          - `reference_image_id` string, nullable, required
          - `url` string, nullable, required
          - `asset_role` string, nullable, required
          - `sort_order` integer, required
          - `created_at` string, date-time, nullable, required
      - `brand_kit_projects` AgentBrandKitProject[], required
        - `id` string, required
        - `creator_id` string, required
        - `source` string, nullable, required
        - `status` string, nullable, required
        - `title` string, nullable, required
        - `brand_name` string, nullable, required
        - `website` string, nullable, required
        - `founder_name` string, nullable, required
        - `founder_title` string, nullable, required
        - `brand_positioning` string, nullable, required
        - `target_audience` string, nullable, required
        - `offer_category` string, nullable, required
        - `output_type` string, nullable, required
        - `number_of_pages` integer, required
        - `aspect_ratio` string, nullable, required
        - `output_size` string, nullable, required
        - `compiler_version` string, nullable, required
        - `style_reference_summary` unknown, required
        - `founder_likeness_summary` unknown, required
        - `creative_brief` unknown, required
        - `page_plan` unknown, required
        - `negative_constraints` unknown, required
        - `reference_manifest` unknown, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
        - `pages` AgentBrandKitPage[], required
          - `id` string, required
          - `brand_kit_project_id` string, required
          - `media_asset_id` string, nullable, required
          - `page_number` integer, required
          - `page_title` string, nullable, required
          - `page_goal` string, nullable, required
          - `sections` unknown, required
          - `copy_blocks` unknown, required
          - `layout_direction` string, nullable, required
          - `image_url` string, nullable, required
          - `output_size` string, nullable, required
          - `aspect_ratio` string, nullable, required
          - `reference_manifest` unknown, required
          - `version` integer, required
          - `status` string, nullable, required
          - `created_at` string, date-time, nullable, required
          - `updated_at` string, date-time, nullable, required
    - `page` object, required
      - `limit_per_creator` integer, required
      - `creator_count` integer, required
  - `receipt` unknown, required

## Other responses

- `400`: Invalid query
- `401`: Missing or invalid bearer token
- `403`: Creator or scope access denied
- `500`: Brand kits temporarily unavailable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)