# List brand kits

Retrieves a list of brand kits in an organization. The response includes basic information about each brand kit, such as its name, description, industry, and status. The response does not include the actual content of the brand kit sections or subsections.

Endpoint: GET /api/brands/v1/organizations/{organizationId}/brandkits
Version: v1.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## Path parameters:

  - `organizationId` (string, required)

## Query parameters:

  - `pageNumber` (integer)

  - `pageSize` (integer)

  - `parentId` (any)

  - `status` (any)

  - `search` (any)

  - `referenceType` (any)

  - `referenceId` (any)

  - `includeDeleted` (any)

  - `brandkitIds` (any)

  - `sortBy` (string)

  - `sortType` (string)

## Response 200:

  - `200` (unknown)
    Brand kits retrieved successfully

## Response 200 fields (application/json):

  - `totalCount` (integer, required)
    The total number of brand kits available in the organization.
    Example: 10

  - `pageSize` (integer, required)
    The number of brand kits returned per page.
    Example: 5

  - `pageNumber` (integer, required)
    The current page number of the brand kits list.
    Example: 1

  - `data` (array, required)
    An array of brand kits available in the organization.

  - `data.organizationId` (string, required)
    The unique identifier of your organization.
    Example: org_ABCDef123456

  - `data.id` (string, required)
    The unique identifier of the brand kit.
    Example: a1234bcd-efg5-678h-910i-jklmnopqrstu

  - `data.description` (any)
    A brief description of the brand kit.
    Example: Brand kit for the Powerful energy bars EU market.

  - `data.name` (string, required)
    The name of the brand kit.
    Example: Powerful EU brand kit

  - `data.brandName` (any)
    The name of the brand associated with this brand kit.
    Example: Powerful

  - `data.companyName` (any)
    The name of the company if different from the brand name.
    Example: Powerful Europe Ltd.

  - `data.logo` (any)
    The URL of the PNG image used as the brand kit logo.
    Example: https://example.com/logo.png

  - `data.status` (any)
    The current status of the brand kit.
    Example: Draft

  - `data.parentId` (any)
    The parent brand kit ID. Used when AI creates a new version of the brand kit during brand ingestion to indicate the original brand kit it's based on.
    Example: a1234bcd-efg5-678h-910i-abcdefghijklmn

  - `data.parentType` (any)
    The type of parent this brand kit belongs to.
    Example: brandkit

  - `data.industry` (any)
    The industry this brand kit is associated with.
    Example: retail

  - `data.createdOn` (any)
    The date and time when the brand kit was created, formatted in ISO 8601.
    Example: 2025-06-18T12:46:12.718310Z

  - `data.createdBy` (any)
    The user who created the brand kit.
    Example: mman

  - `data.updatedOn` (any)
    The date and time when the brand kit was last updated, formatted in ISO 8601.
    Example: 2025-06-18T12:46:12.718310Z

  - `data.updatedBy` (any)
    The user who last updated the brand kit.
    Example: mman

  - `data.tags` (any)
    An array of tags associated with the brand kit to categorize its documents.
    Example: []

  - `data.tags.category` (string, required)
    The main grouping or classification applied to the brand kit.
    Example: audience

  - `data.tags.values` (array, required)

  - `data.references` (any)
    An array of references associated with the brand kit.
    Example: []

  - `data.references.id` (string, required)
    The unique identifier of the reference document.
    Example: 2ad5c154-6404-49ed-9ffc-0603c360a5af

  - `data.references.path` (string, required)
    The location of the reference.
    Example: /path

  - `data.references.type` (string, required)
    The type of reference used.
    Example: document

  - `data.deletedAt` (any)
    The date and time when the brand kit was deleted, formatted in ISO 8601.
    Example: 2025-06-18T12:46:12.718310Z

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)