Get active brand for hostname (resolved)

GET

/resellers/{reseller}/brands/{hostname}/active

Last modified:2026-04-30 01:17:30

Resolve and return the best-matching active brand for the given hostname and reseller.

Resolution order (one query, highest priority wins):

Priority	hostname	reseller	domain
1	H	R	D
2	H	R	*
3	H	*	D
4	H	*	*
5	*	R	D
6	*	R	*
7	*	*	D
8	*	*	*

The domain query param scopes the lookup. Without it, only domain=* rows are candidates.

Response includes matched-hostname and a fully merged assets array from the full hierarchy candidate set. Each asset includes source-hostname, source-reseller, source-domain, source-brand-name indicating which hierarchy level contributed it. Note: file-access-url is not included on hierarchy asset entries.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Active brand with merged assets. matched-hostname is populated. Asset entries include source-* fields but not file-access-url.

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers/{{reseller}}/brands/portal.acme.com/active?domain' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": "5d41402abc4b2a76b9719d911017c592",
    "hostname": "portal.acme.com",
    "reseller": "acme",
    "domain": "*",
    "brand-name": "ACME Blue",
    "currently-active": 1,
    "matched-hostname": "portal.acme.com",
    "color-primary": "#1E40AF",
    "border-radius": "rounded",
    "icon-style": "baseline",
    "assets": [
        {
            "id": "c20ad4d76fe97759aa27a0c99bff6710",
            "brand-id": "5d41402abc4b2a76b9719d911017c592",
            "asset-type": "logo",
            "filename": "acme-logo.png",
            "mime-type": "image/png",
            "width": 200,
            "height": 80,
            "file-size-bytes": 45678,
            "source-hostname": "*",
            "source-reseller": "acme",
            "source-domain": "*",
            "source-brand-name": "default"
        }
    ]
}

Modified at 2026-04-30 01:17:30

Get all brands for reseller + hostname (full data)

Get a specific brand (full data)