List brands

Returns every active brand configured for the merchant. Use this endpoint to build brand pickers or to load brand metadata before filtering with brand_id.

Requires a Fire spark access token obtained through token exchange. The token scopes requests to the authenticated customer and merchant.

Request

curl "https://firespark.cloud/api/storefront/v1/brands" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Response

The response wraps an array of brand objects in data. Only ACTIVE brands are included.

{
  "data": [
    {
      "id": "0001",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "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"
          }
        ]
      }
    },
    {
      "id": "0002",
      "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "name": "Taco Co.",
      "status": "ACTIVE",
      "cms_template_id": null,
      "cms": null
    }
  ]
}

Brand object

Field	Type	Description
`id`	string	External brand identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. Use this value in `brand_id` when filtering stores and channels.
`uid`	string (UUID)	Fire spark internal identifier.
`merchant_id`	string (UUID)	Fire spark merchant identifier.
`name`	string	Display name. 1–100 characters.
`status`	string	`ACTIVE` or `INACTIVE`.
`cms_template_id`	string (UUID)	CMS template linked to this brand. `null` when no template is assigned.
`cms`	object	Read-only. `null` when `cms_template_id` is `null`. When set, the resolved CMS template for this brand, including field definitions and stored values.

cms

Present only when cms_template_id is not null. Contains the resolved CMS template assigned to the brand.

Field	Required	Type	Description
`id`	Yes	string (UUID)	Template identifier. Matches `cms_template_id`.
`name`	Yes	string	Template name. 1–100 characters.
`entity`	Yes	string	Always `BRANDS` for brand responses.
`status`	Yes	string	`ACTIVE` or `INACTIVE`.
`fields`	Yes	array	Template fields with their current stored values.

Each field in fields:

Field	Required	Type	Description
`name`	Yes	string	Field key.
`type`	Yes	string	`TEXT`, `SELECT`, `IMAGE`, or `LIST`.
`label`	No	object	Optional localized label keyed by locale.
`required`	No	boolean	Whether the field is required.
`placeholder`	No	string	Optional placeholder text.
`options`	No	array	For `SELECT` fields — objects with `label` and `value`.
`altText`	No	string	For `IMAGE` fields — alternative text.
`src`	No	string	For `IMAGE` fields — image URL.
`href`	No	string	For `IMAGE` fields — optional link URL.
`value`	No	varies	Current stored value for this brand. Omitted when empty.

Error responses

Status	Description
`401`	Missing or invalid access token.
`403`	Token does not have access to this merchant’s brands.

API Documentation

Endpoints

Guides

Resources

Request

Response

Brand object

Error responses

​Request

​Response

​Brand object

​Error responses

Request

Response

Brand object

Error responses