---
title: "Get a brand"
method: GET
path: "/v1/brands/{brand}"
tags: ["brands"]
---

# Get a brand

`GET /v1/brands/{brand}`

Retrieve a brand by its brandId or slug, for example, `/v1/brands/123` or `/v1/brands/abc`

## Path parameters

- `brand` string, required

## Query parameters

- `forceSlug` boolean

## Response `200`

request successful

- Brand — Brand information
  - `id` integer, required — The unique identifier of the brand (referred as `attributeId`), can be used for retrieving specific brand. ID which would be used to filter for brands in the `products` and `filters` endpoint
  - `slug` string, required — short text to describe the current category (usable, for example, in URLs as `fashion`).
  - `name` string, required
  - `customData` BrandCustomData, required — Arbitrary custom data object to be added to the brand.
  - `externalReference` string, required — External reference set by the client to integrate a third-party party system.
  - `group` string, required — Brand group.
  - `isActive` boolean, required — Whether the brand is currently active or not.
  - `logoHash` string, required — Logo hash used for generating the full url.
  - `createdAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00
  - `updatedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00
  - `indexedAt` string, required — Date string, formatted according to RFC 3339, e.g. 2018-06-01T14:56:08+02:00

## Other responses

- `400` — Required query parameter missing / invalid
- `401` — Authentication information is missing or invalid
- `404` — The specified resource was not found

## Changes

- **2023-08-06** `302b7c443b51` — 3 breaking, 1 warning, 6 info
  - for the `path` request parameter `brand`, the type/format was changed from `string`/`` to `integer`/``
  - the response property `customData` became optional for the status `200`
  - the response property `externalReference` became optional for the status `200`
  - deleted the `query` request parameter `forceSlug`
  - …6 more

[Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/brands/:brand/get.md)

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)