> ## Documentation Index > Fetch the complete documentation index at: https://docs.rainbrand.com/llms.txt > Use this file to discover all available pages before exploring further. # List brands > List the brands you can access. ## OpenAPI ````yaml https://www.rainbrand.com/api/v1/spec.json get /brands openapi: 3.1.1 info: title: Rainbrand API version: 1.0.0 servers: - url: https://www.rainbrand.com/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Uploads description: >- Stage private local files for brand sources, the Library, and other supported operations. - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Library description: Add, list, and remove a brand's images, video, and audio. - name: Images description: Retrieve and manage images. - name: Videos description: Retrieve and manage video files. - name: Audio description: Retrieve and manage audio files. - name: Briefs description: Get brand guidance and selected assets for a specific task. - name: Models description: Find available models and check their inputs. - name: Generations description: Create and retrieve model generations. - name: Reviews description: >- Check an asset against a brand's color, typography, logo, and copy guidance. paths: /brands: get: tags: - Brands summary: List brands description: List the brands you can access. operationId: brands.list parameters: - name: workspaceId in: query schema: type: string minLength: 1 description: >- Team workspace ID. Scopes results to that workspace. Omit to list across every workspace the caller can see. allowEmptyValue: true allowReserved: true - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 50 description: Results per page (1–100, default 50) allowEmptyValue: true allowReserved: true - name: cursor in: query schema: type: string description: Pagination cursor from a previous response's nextCursor allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: brands: type: array items: type: object properties: id: type: string format: uuid name: type: string status: enum: - analyzing - ready - logo_required - failed type: string imageCount: type: number description: >- Number of completed generated images that have not been deleted. libraryImageCount: type: integer minimum: 0 maximum: 9007199254740991 description: >- 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: anyOf: - type: string - type: 'null' workspaceName: type: string createdAt: type: string format: date-time x-native-type: date required: - id - name - status - imageCount - libraryImageCount - workspaceId - workspaceName - createdAt nextCursor: anyOf: - type: string - type: 'null' hasMore: type: boolean required: - brands - nextCursor - hasMore required: - data '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/BrandsList401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/BrandsList403ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/BrandsList429ErrorResponse' headers: Retry-After: description: >- Seconds until the applicable request or operation limit resets. Present when the limiter can calculate the delay. schema: type: integer minimum: 0 components: schemas: BrandsList401ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: UNAUTHORIZED status: const: 401 message: type: string default: Invalid or missing API credentials data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsList403ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: ACCOUNT_BANNED status: const: 403 message: type: string default: This account has been suspended. data: {} required: - code - status - message - type: object properties: code: const: FORBIDDEN status: const: 403 message: type: string default: Plan upgrade required data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsList429ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: TOO_MANY_REQUESTS status: const: 429 message: type: string default: Rate limit exceeded data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ApiError: type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Rainbrand API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: >- Rainbrand API key (`Bearer bloom_sk_...`) or Rainbrand OAuth access token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.