> ## 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.

# Get Brand

> Retrieve detailed information about a specific brand

Retrieve detailed information about a specific brand, including aggregate statistics for prompts, answers, and competitors.

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

### Path Parameters

<ParamField path="brandId" type="string" required>
  The unique brand identifier
</ParamField>

### Response

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

<ResponseField name="brand" type="object">
  <Expandable title="Brand details">
    <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>

    <ResponseField name="description" type="string">
      Brand description (can be null)
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation timestamp
    </ResponseField>

    <ResponseField name="stats" type="object">
      <Expandable title="Brand statistics">
        <ResponseField name="promptsCount" type="number">
          Number of prompts tracked for this brand
        </ResponseField>

        <ResponseField name="answersCount" type="number">
          Total number of AI responses analyzed
        </ResponseField>

        <ResponseField name="competitorsCount" type="number">
          Number of competitors (SELF + DIRECT)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Request

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

### Example Response

```json theme={null}
{
  "success": true,
  "brand": {
    "id": "cm1234567890abcdef",
    "name": "My Brand",
    "domain": "mybrand.com",
    "description": "Leading provider of innovative solutions",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "stats": {
      "promptsCount": 156,
      "answersCount": 312,
      "competitorsCount": 8
    }
  }
}
```

### Error Responses

| Status | Code              | Description                           |
| ------ | ----------------- | ------------------------------------- |
| 401    | `INVALID_TOKEN`   | Authentication failed                 |
| 404    | `BRAND_NOT_FOUND` | Brand doesn't exist or not accessible |