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

# Get brand

> Retrieve a single brand by its external identifier.

Returns one brand by external `id`. Use this endpoint after the customer selects a brand to load its name, status, and CMS content for the storefront.

<Note>
  Requires a Fire spark access token obtained through [token
  exchange](/docs/storefront-api/oauth/exchange/post).
</Note>

## Path parameters

| Parameter | Required | Description                                                                             |
| --------- | -------- | --------------------------------------------------------------------------------------- |
| `id`      | Yes      | External brand identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. |

## Request

```bash theme={null}
curl "https://firespark.cloud/api/storefront/v1/brands/0001" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps a single brand object in `data`. The shape matches [list brands](/docs/storefront-api/brands/get).

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "0001",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "organization_id": "11111111-1111-1111-1111-111111111111",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "name": "Burger Co.",
      "status": "ACTIVE",
      "cms_template_id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
      "cms": {
        "id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
        "name": "Brand landing page",
        "entity": "BRANDS",
        "status": "ACTIVE",
        "fields": [
          {
            "name": "tagline",
            "type": "TEXT",
            "label": { "en_us": "Tagline" },
            "required": false,
            "value": "Flame-grilled since 1987"
          }
        ]
      }
    }
  }
  ```
</ResponseExample>

## Brand fields

See [list brands](/docs/storefront-api/brands/get) for the full schema, including `cms_template_id` and `cms`.

<Tip>
  Pass the brand `id` in the `brand_id` header on [list
  stores](/docs/storefront-api/stores/get) and [list
  channels](/docs/storefront-api/channels/get) to scope results to that brand.
</Tip>

## Error responses

| Status | Description                               |
| ------ | ----------------------------------------- |
| `401`  | Missing or invalid access token.          |
| `403`  | Token does not have access to this brand. |
| `404`  | No brand found with the given `id`.       |


## OpenAPI

````yaml GET /brands/{id}
openapi: 3.0.1
info:
  title: Fire spark Integrations API
  description: POS and RMS integration endpoints for Fire spark.
  version: 1.0.0
servers:
  - url: https://firespark.cloud/api/integrations/v1
security:
  - bearerAuth: []
paths:
  /brands/{id}:
    get:
      summary: Get brand
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9_-]+$
          description: External brand identifier.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BrandRead'
components:
  schemas:
    BrandRead:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_-]+$
        uid:
          type: string
          format: uuid
        organization_id:
          type: string
          format: uuid
        merchant_id:
          type: string
          format: uuid
        name:
          type: string
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
        cms_template_id:
          type: string
          format: uuid
          nullable: true
        cms:
          type: object
          nullable: true
          additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````