> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Brands

> Retrieves a list of all available brands for your organization

Retrieves a list of all available brands for your organization. This endpoint returns basic brand information including brand IDs and names that can be used for filtering and organization purposes.

## Request Parameters

This endpoint does not require any specific parameters, but standard authentication is required.

| Parameter | Type | Description                                         | Required |
| --------- | ---- | --------------------------------------------------- | -------- |
| None      | -    | This endpoint does not accept additional parameters | -        |

## Request Example

```bash theme={null}
curl -X GET "https://api.growi.io/api/public/v1/organizations/brands" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"
```

## Response Example

```json theme={null}
{
  "success": true,
  "brands": [
    {
      "id": 0,
      "name": "Name"
    },
    {
      "id": 1,
      "name": "Name 2"
    }
  ]
}
```

## Response Fields

| Field           | Type    | Description                                  |
| --------------- | ------- | -------------------------------------------- |
| `success`       | Boolean | Indicates whether the request was successful |
| `brands`        | Array   | Array of brand objects                       |
| `brands[].id`   | Integer | Unique identifier for the brand              |
| `brands[].name` | String  | Display name of the brand                    |

## Use Cases

* **Brand Filtering**: Use brand IDs to filter data in other API endpoints
* **Brand Management**: Retrieve available brands for management interfaces
* **Organization Setup**: Get brand information for initial application setup
* **Reporting**: Include brand names in reports and analytics dashboards

## Error Responses

```json theme={null}
{
  "error": "Not Authenticated"
}
```

Common error scenarios:

* **401 Unauthorized**: Invalid or missing Bearer token
* **403 Forbidden**: API key doesn't have permission to access brands
* **500 Internal Server Error**: Server-side error occurred


## OpenAPI

````yaml GET /organizations/brands
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /organizations/brands:
    get:
      description: Retrieves a list of all available brands for your organization
      responses:
        '200':
          description: Get your brands information
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  brands:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 0
                          description: Unique identifier for the brand
                        name:
                          type: string
                          example: Name
                          description: Display name of the brand
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Organization not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Organization not found
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````