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

# List brands

`GET /brands`

Returns a paginated list of brands.

🔒 Requires: `products:read` scope

## Query parameters

- `after` integer
- `before` integer
- `page_size` integer
- `deleted` boolean

## Response `200`

OK

- BrandCollection
  - `data` Brand[], required — An array of Brand objects wrapped in top level `data` object.
    - `deleted_at` string, nullable — Deletion timestamp in UTC.
    - `description` string, nullable — The brand description.
    - `id` string, required — Auto-generated object ID.
    - `name` string, required — The brand name.
    - `version` integer — Auto-incrementing object version number.
  - `version` Version, required — An object containing the highest and lowest version numbers for all items of the returned collection.
    - `max` integer, nullable, required — Highest version number of the payload, or `null` when the result set is empty.
    - `min` integer, nullable, required — Lowest version number of the payload, or `null` when the result set is empty.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)