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

# List brands

> Return all brands that belong to your organization.

Brands are the top-level entities you track in Spotlight (e.g. your company or product lines). Call this endpoint first to discover available `brandId` values for use in other endpoints.

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -s \
    -H "x-spotlight-api-key: YOUR_API_KEY" \
    "https://app.get-spotlight.com/api/v1/brands"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://app.get-spotlight.com/api/v1/brands",
      headers={"x-spotlight-api-key": "YOUR_API_KEY"},
  )
  brands = r.json()["data"]
  ```

  ```javascript JavaScript theme={null}
  const r = await fetch("https://app.get-spotlight.com/api/v1/brands", {
    headers: { "x-spotlight-api-key": "YOUR_API_KEY" },
  });
  const { data } = await r.json();
  ```
</CodeGroup>

### Response

<ResponseField name="data" type="Brand[]">
  Array of brand objects.

  <Expandable title="Brand object">
    <ResponseField name="id" type="string">
      Unique brand identifier — use this as `{brandId}` in other endpoints.
    </ResponseField>

    <ResponseField name="name" type="string">
      Internal slug-style name.
    </ResponseField>

    <ResponseField name="displayName" type="string">
      Human-readable label shown in the app.
    </ResponseField>

    <ResponseField name="targetMarket" type="string | null">
      The audience this brand targets, e.g. `"US SMB"`.
    </ResponseField>

    <ResponseField name="language" type="string">
      Primary language code, e.g. `"en"`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="count" type="integer">
  Total number of brands returned.
</ResponseField>

```json theme={null}
{
  "data": [
    {
      "id": "brand-uuid-123",
      "name": "my-brand",
      "displayName": "My Brand",
      "targetMarket": "US SMB",
      "language": "en"
    }
  ],
  "count": 1
}
```