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

# List Brands

`GET /v1/brands`

Paginated list of brands, capped at the top 5,000.

## Query parameters

- `limit` integer — Max items per page (1-100).
- `cursor` string, nullable — Pagination cursor returned by a prior call. Omit for the first page.
- `country` 'US' | 'GB' | 'EU' | 'AU' | 'CA' | 'IE' | 'DE' | 'AT' | 'FR' | 'BE' | 'IT' | 'ES' | 'NL' | 'SE' | 'FI' | 'PT' | 'CZ' | 'GR' | 'RO', nullable — ISO 3166-1 alpha-2 country code that `best_commission_rate` is scoped to. Defaults to 'US' when unset.

## Response `200`

Successful Response

- PaginatedListBrandsResponse
  - `items` Brand[], required — List of brands
    - `id` string, required
    - `name` string, required
    - `logo_url` string, nullable
    - `description` string, nullable
    - `best_commission_rate` number — The maximum commission rate for the brand in the requested country (default 'US'), as a percentage
  - `next_cursor` string, nullable — Cursor to fetch the next page of results. Null if no more results.

## Other responses

- `401` — Unauthorized - Invalid or missing authentication
- `402` — Payment required
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.net/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/channel3-ai/fastapi/versions/981d371bd83e/schema)