---
title: "Get Brands"
method: GET
path: "/get-brands"
tags: ["public-api"]
---

# Get Brands

`GET /get-brands`

## Request

- Base URL: `https://api.trakkr.ai`
- URL: `https://api.trakkr.ai/get-brands`
- Auth: HTTP bearer

List all brands accessible to your API key.

Returns brands available through direct membership, current team grants,
or an active client assignment. Client assignments are always read-only.
Optionally include markets, aliases, and/or the brand's own description with
?include=markets,aliases,profile. Filter to a single brand with ?brand_id=X.

## Query parameters

- `brand_id` string, uuid, nullable: Filter to a single brand by UUID
- `include` string, nullable: Comma-separated: markets, aliases, profile

## Response `200`

Successful Response

- BrandsExtendedResponse: GET /get-brands response (extended).
  - `brands` BrandItemExtended[], required
    - `id` string, required
    - `name` string, required
    - `website` string, nullable
    - `favicon` string, nullable
    - `active` boolean
    - `role` 'owner' | 'editor' | 'viewer'
    - `location` string, nullable
    - `location_region` string, nullable
    - `location_city` string, nullable
    - `markets` MarketItem[], nullable
      - `language` string, nullable: Question language (BCP-47), independent of the country.
      - `id` string, required
      - `brand_id` string, required
      - `location` string, required
      - `location_region` string, nullable
      - `location_city` string, nullable
      - `is_primary` boolean, required
      - `active` boolean, required
      - `created_at` string, required
    - `aliases` string[], nullable
    - `description` string, nullable

## Other responses

- `401`: Missing, malformed, or expired credentials
- `402`: The current plan does not fund this operation
- `403`: Invalid credentials, missing brand access, or insufficient role
- `422`: Validation Error
- `429`: Rate limit exceeded
- `500`: The operation failed
- `503`: Authentication, entitlement, or a required dependency is temporarily unavailable

---

[API](https://skmtc.dev/trakkr/apis/trakkr-api.md) · [All operations](https://skmtc.dev/trakkr/apis/trakkr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trakkr/apis/trakkr-api/revisions/189a9e76b8d5?raw)