Get active brand for hostname (full data)

GET

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

Last modified:2026-02-04 00:21:55

Retrieve the active brand (currently-active=1) for the specified reseller and hostname.

Note: This endpoint returns the complete Brand schema including:

All styling properties (colors, fonts, spacing)

Nested assets object with metadata

All metadata fields (id, created, modified)

matched-hostname field showing which hostname in the hierarchy was matched

Uses hierarchical hostname matching:

Exact match (portal.acmecorp.com)

Parent domain (acmecorp.com)

Grandparent domain (com) - if applicable

Default fallback (default.netsapiens.com)

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Active brand configuration with nested assets

Body

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers//brands//active' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "5d41402abc4b2a76b9719d911017c592",
    "hostname": "portal.acmecorp.com",
    "reseller": "acme-reseller",
    "brand-name": "ACME Blue Theme",
    "description": "Customer-facing portal branding",
    "currently-active": 1,
    "color-primary": "#1E40AF",
    "color-secondary": "#7C3AED",
    "font-family": "Inter, sans-serif",
    "font-size-pixels": 16,
    "matched-hostname": "portal.acmecorp.com",
    "assets": [
        {
            "asset-type": "logo",
            "id": "c20ad4d76fe97759aa27a0c99bff6710",
            "brand-id": "5d41402abc4b2a76b9719d911017c592",
            "filename": "acme-logo.png",
            "mime-type": "image/png",
            "width": 200,
            "height": 80
        }
    ]
}

Modified at 2026-02-04 00:21:55

Get a specific brand (full data)

Create a new brand