---
title: "List Brands"
method: GET
path: "/brands"
tags: ["Project"]
---

# List Brands

`GET /brands`

List the brands of a project

## Query parameters

- `project_id` string — Required if using a company api key
- `limit` number
- `offset` number

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `id` string, required
    - `name` string, required
    - `domains` string[]
    - `aliases` string[]
    - `is_own` boolean, required
    - `color` string, required — Hex color of the brand
    - `source` 'manual' | 'suggestion' | 'onboarding' — How the brand was added: 'manual' for direct creation, 'suggestion' for accepted brand suggestions, 'onboarding' for autogenerated competitors seeded at project start. Absent for brands created before this field was tracked.
  - `total_count` number, required — Total number of brands, ignoring pagination
  - `totalCount` number, required — Total number of brands, ignoring pagination

---

[API](https://skmtc.net/peec/apis/peec-ai-customer-api.md) · [All operations](https://skmtc.net/peec/apis/peec-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peec/peec-ai-customer-api/versions/92840a1bffa7/schema)