Fetch a brand's resolved theme (POL-642).

GET

/brands/{brandSlug}/theme

• Production
• Staging
• Local dev

Public endpoint used by every renderer that fetches a brand’s theme directly (script-tag widget, SDKs). Returns the theme with defaults merged (version: 0 when the brand has no overrides).

Parameters

Path Parameters

brandSlug

required

Brand slug (DNS-label-safe, ≤63 chars).

string

>= 1 characters <= 63 characters

Brand slug.

Responses

200

Resolved brand theme.

object

data

required

object

accent

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

background

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

foreground

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

radius

required

string

Allowed values: NONE SM MD LG FULL

density

required

string

Allowed values: COMPACT COMFORTABLE

fontStack

required

string

Allowed values: SYSTEM SERIF MONO BRAND

fontBrandUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoLightUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoDarkUrl

required

Any of:

string

string

<= 2048 characters

null

null

faviconUrl

required

Any of:

string

string

<= 2048 characters

null

null

hideWatermark

required

boolean

customCss

required

Any of:

string

string

<= 4096 characters

null

null

version

required

integer

<= 9007199254740991

titleColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

titleSize

required

Any of:

integer

integer

>= 10 <= 96

null

null

titleWeight

required

Any of:

integer

integer

>= 100 <= 900

null

null

titlePlacement

required

string

Allowed values: ABOVE BELOW HIDDEN

labelColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

labelSize

required

Any of:

integer

integer

>= 10 <= 72

null

null

labelPlacement

required

string

Allowed values: HEADER OVERLAID BELOW HIDDEN

labelAlign

required

string

Allowed values: LEFT CENTER

headerFill

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeBg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeFg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeDiameter

required

Any of:

integer

integer

>= 24 <= 96

null

null

imageRatio

required

Any of:

number

number

>= 0.25 <= 4

null

null

elevation

required

string

Allowed values: FLAT LIFTED

404

Brand not found.

422

BrandSlug failed validation.