List domain brands for hostname

GET

/domains/{domain}/brands/{hostname}

Last modified:2026-10-09 00:54:55

OperationId:GetBrandsForDomainByHostname

Returns the brands scoped to one domain and one hostname, with every styling field and their assets, 100 at a time unless you set limit. Requires Reseller, Super User, or Super User Read Only scope. A Reseller reaches only the domains in its own territory. The reseller is taken from the domain.

* in the path returns the brands stored for every hostname; it is not a wildcard. Filter with brand-name, and currently-active. Page with limit and start, and order with sort. fields returns only the fields you name.

Each brand carries its assets: metadata for its images, never the image itself. See the assets field for the names those entries use.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

The brands for the domain and hostname. An empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//brands/portal.example.com?currently-active=1&limit=undefined&start=undefined&brand-name=Blue%20Theme&sort=brand_name%20asc&fields=brand-name%2Chostname%2Ccurrently-active' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Domain brands for one hostname

[
    {
        "id": "857f2c8ee324d783afc03b3921d826d5",
        "hostname": "portal.example.com",
        "reseller": "example-reseller",
        "domain": "example.com",
        "brand-name": "Sales Theme",
        "description": "Theme for the sales domain",
        "currently-active": 1,
        "color-primary": "#0F766E",
        "color-secondary": "#7C3AED",
        "color-success": "#059669",
        "color-info": "#0284C7",
        "color-error": "#DC2626",
        "color-warning": "#D97706",
        "font-family": "Inter, sans-serif",
        "font-family-url": null,
        "font-size-pixels": 16,
        "margin-pixels": 16,
        "padding-pixels": 16,
        "border-radius": 8,
        "icon-style": "baseline",
        "powered-by": "Powered by Example Company",
        "email-sender": "noreply@example.com",
        "created": "2026-09-03 11:00:00",
        "modified": "2026-09-03 11:00:00",
        "assets": [
            {
                "id": "259878452a8918f757a80438f613ef1d",
                "brand_id": "857f2c8ee324d783afc03b3921d826d5",
                "asset_type": "logo",
                "filename": "sales-logo.svg",
                "mime-type": "image/svg+xml",
                "width": 240,
                "height": 64,
                "file_size": 3920,
                "created": "2026-09-01 14:30:00",
                "modified": "2026-09-01 14:30:00",
                "download_url": "https://core1.example.com/ns-api/v2/domains/example.com/brands/portal.example.com/Sales+Theme/assets/logo/download"
            }
        ]
    }
]

Modified at 2026-10-09 00:54:55

List domain brand summaries for hostname

Read active domain brand for hostname