---
title: "Resolve theme"
method: GET
path: "/{tenant}/resolved"
tags: ["ThemeResolution"]
---

# Resolve theme

`GET /{tenant}/resolved`

Resolves the effective theme for a tenant, optionally scoped to a registered
application and variant. Later scopes win: SYSTEM < PRODUCT < TENANT < APPLICATION
< PRINCIPAL; the PRODUCT and APPLICATION layers apply only when `applicationId` is
supplied. Returns 404 for an unknown tenant; a known tenant with no definitions
resolves to system defaults with `fallback=true` and `X-Theme-Fallback: true`.

## Parameters

- `./theme-components.yml#/components/parameters/VariantQuery` — unresolved $ref
- `./theme-components.yml#/components/parameters/ApplicationIdQuery` — unresolved $ref
- `./theme-components.yml#/components/parameters/ResolutionModeQuery` — unresolved $ref
- `./theme-components.yml#/components/parameters/IfNoneMatchHeader` — unresolved $ref

## Response `200`

Resolved theme.

- ResolvedTheme — unresolved $ref

## Other responses

- `304` — Cached theme is still current.
- `404` — unresolved $ref
- `500` — unresolved $ref

## Changes

- **2026-07-07** `e1e9983e1809` — 4 info
  - api tag `ThemeResolution` added
  - api tag `ThemeBranding` removed
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`

[Change history](https://skmtc.dev/sphereon-opensource/apis/theme-api/changes/:tenant/resolved/get.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/theme-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/theme-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/theme-api/revisions/a2197538ab3a/schema)