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

# List Brands

> Retrieve all brands accessible to your team

Brands are the core entities in Qwairy. Each brand represents a company or product you monitor across AI platforms. This endpoint returns every brand your team can access.

<Note>
  See [Entities](/developers/entities#brand) for the complete Brand object structure.
</Note>

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer qw-api-xxx`
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="total" type="number">
  Total number of brands
</ResponseField>

<ResponseField name="brands" type="array">
  <Expandable title="Brand object">
    <ResponseField name="id" type="string">
      Unique brand identifier (UUID)
    </ResponseField>

    <ResponseField name="name" type="string">
      Brand display name
    </ResponseField>

    <ResponseField name="domain" type="string">
      Primary domain for the brand
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Request

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

### Example Response

```json theme={null}
{
  "success": true,
  "total": 2,
  "brands": [
    {
      "id": "cm1234567890abcdef",
      "name": "My Brand",
      "domain": "mybrand.com"
    },
    {
      "id": "cm0987654321fedcba",
      "name": "My Other Brand",
      "domain": "myotherbrand.com"
    }
  ]
}
```

## Next Steps

Once you have your brand IDs, you can:

* [Get performance metrics](/developers/endpoints/performance)
* [List competitors](/developers/endpoints/competitors/list)
* [View source domains](/developers/endpoints/source-domains/list)
* [View source URLs](/developers/endpoints/source-urls)
* [Browse prompts](/developers/endpoints/prompts/list)
