---
title: "Widget Theme"
method: GET
path: "/widget-theme/brand/{brandId}"
tags: ["Theme"]
---

# Widget Theme

`GET /widget-theme/brand/{brandId}`

## Request

- Base URL: `https://opti-ls-api-us.optimove.net/api`
- URL: `https://opti-ls-api-us.optimove.net/api/widget-theme/brand/{brandId}`
- Auth: none declared

Branding colors and CSS variables configured by the brand owner in the Optimove dashboard. Apply these to style your widget to match the brand's identity.

> 🚧 CSS safety
>
> `globalCss` and `customCss` are raw values from the API. Before injecting them as live styles, allow-list the CSS properties and selectors your widget accepts to prevent unintended style injection.

## Path parameters

- `brandId` string, uuid, required

## Response `200`

Theme configuration for the brand.

- WidgetTheme
  - `themeColors` object: Nested color palette. Keys are color names (e.g. `primary`), values are shade maps (`50` through `900`).
  - `globalCss` object: CSS property/value pairs to apply globally (e.g. border-radius, fonts).
  - `customCss` object: CSS selector/rule pairs for specific widget elements.
  - `customVariables` object: Named values (e.g. sizes, shadows) for use in your CSS as variables or constants.

---

[API](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api.md) - [All operations](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/revisions/f174877a5fb7?raw)