KintsugiKintsugi
API reference / Look up the portfolio a branded host belongs to

Look up the portfolio a branded host belongs to

GET/public/branding-hosts/{host}

Returns the portfolio that a branded host belongs to: either the client app host (for example acme.tax-platform.com) or the portfolio app host (for example acme.portfolio.tax-platform.com). app says which one it is. When white-labeling is available and the portfolio's branding is on, it also returns the portfolio's name, logo, primary color and the name of the Kin assistant. Otherwise the name is "Kintsugi" and the logo, color and Kin name are null. No credential is needed or accepted. Returns 404 when the host is not a claimed branded host.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Path parameters

hoststringRequired

Response

portfolioIdstringRequired

Opaque id of the portfolio this console belongs to. After sign-in, the console acts only within this portfolio.

appBrandingAppRequired

Which of the portfolio's apps this host serves: client for <slug>.tax-platform.com, portfolio for <slug>.portfolio.tax-platform.com.

Available options:clientportfolio
displayNamestringRequired

Name to show on the console. It is the portfolio's own name while its branding is active, and "Kintsugi" otherwise.

logoUrlstring

Public HTTPS URL of the portfolio's logo. Null when its branding is not active; the console then shows the Kintsugi logo.

brandingActivebooleanRequired

True when the console shows this portfolio's own brand: white-labeling is available and the portfolio turned its branding on. displayName, logoUrl, primaryColor and kinName then carry the portfolio's values; otherwise they are the Kintsugi defaults.

primaryColorstring

Primary brand color as #RRGGBB. Null when no color is set or when the theme is not active.

kinNamestring

Custom name for the Kin assistant. Null when none is set or when the theme is not active. The console then uses "Kin".

200

Successful Response

404

The requested resource was not found.

422

Validation Error

cURL
GET /public/branding-hosts/{host}
-H "Api-Version: 2026-10-06"
Example request
https://api.trykintsugi.com/public/branding-hosts/{host}
Response
{
"portfolioId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"app": "client",
"displayName": "Acme Corp",
"logoUrl": "https://www.example.com",
"brandingActive": false,
"primaryColor": "#1F6FEB",
"kinName": "Acme Corp"
}
Look up the portfolio a branded host belongs to (2026-10-06) | Kintsugi API Reference