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

> Read one brand configuration by external id.

Returns a single brand for the authenticated merchant. Use this endpoint when you already know the external `id` and need the current configuration without listing all brands.

<Note>
  Requires an access token with the `brands:read` scope. See
  [Token](/docs/integrations-api/oauth/token/post) to obtain a token.
</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/integrations/v1/brands/0001" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Response

The response wraps one brand object in `data`. The shape matches [List brands](/docs/integrations-api/brands/get).

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "id": "0001",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "organization_id": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
      "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
      "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>

## Error responses

| Status | Description                          |
| ------ | ------------------------------------ |
| `401`  | Missing or invalid access token      |
| `403`  | Token does not include `brands:read` |
| `404`  | No brand exists for this id          |


## OpenAPI

````yaml integrations-api/openapi.json 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

````