---
title: "Widget Branding"
method: GET
path: "/api/widgets/branding"
tags: ["Widgets"]
---

# Widget Branding

`GET /api/widgets/branding`

## Request

- Base URL: `https://api.xfinlab.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xfinlab.com/api/widgets/branding`
- Auth: none declared

2026-08-09 (white-label Tier A): public lookup embed.js calls when
a data-xfl-key attribute is present on the script tag. Always 200s
with {"available": False} for a missing/free/invalid key -- never an
error, since a failed branding lookup must degrade to today's
default XFINLAB-branded rendering, not a broken widget. See
services/widget_branding_service.py for the Pro/Enterprise tiering
and re-verification-at-read-time contract.

## Query parameters

- `key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xfinlab/apis/xfinlab-api.md) · [All operations](https://skmtc.dev/xfinlab/apis/xfinlab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xfinlab/apis/xfinlab-api/revisions/205f85614bc6?raw)