---
title: "List Brands"
method: GET
path: "/v0/list-brands"
tags: ["channel3-api"]
---

# List Brands

`GET /v0/list-brands`

Lists all brands, sorted alphabetically.
Supports pagination with the cursor parameter.

## Query parameters

- `limit` integer — Max results (1-100)
- `cursor` string, nullable — Pagination cursor

## 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

## Changes

- **2026-05-21** `48ea59b2e819` — 4 info
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `401`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `402`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `422`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `500`
- **2026-03-03** `4a56c45ff30e` — 2 warning, 2 info
  - deleted the `query` request parameter `paging_token`
  - removed the optional property `paging_token` from the response with the `200` status
  - added the new optional `query` request parameter `cursor`
  - added the optional property `next_cursor` to the response with the `200` status

[Change history](https://skmtc.dev/channel3-ai/apis/fastapi/changes/v0/list-brands/get.md)

---

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