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

# List brands

`GET /brands`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/brands`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

List the brands you can access.

## Query parameters

- `workspaceId` string: Team workspace ID. Scopes results to that workspace. Omit to list across every workspace the caller can see.
- `limit` integer: Results per page (1–100, default 50)
- `cursor` string: Pagination cursor from a previous response's nextCursor

## Response `200`

OK

- object
  - `data` object, required
    - `brands` object[], required
      - `id` string, uuid, required
      - `name` string, required
      - `status` 'analyzing' | 'ready' | 'logo_required' | 'failed', required
      - `imageCount` number, required: Number of completed generated images that have not been deleted.
      - `libraryImageCount` integer, required: Number of saved images in this brand's Brand Library, such as user uploads, images imported from websites or social profiles, and logos or graphics extracted from official brand sources. Excludes generated images.
      - `workspaceId` string, nullable, required
      - `workspaceName` string, required
      - `createdAt` string, date-time, required
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: 401
- `403`: 403
- `429`: 429

---

[API](https://skmtc.dev/rainbrand/apis/rainbrand-api.md) - [All operations](https://skmtc.dev/rainbrand/apis/rainbrand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rainbrand/apis/rainbrand-api/revisions/012b8e9da4df?raw)