Read reseller brand

GET

/resellers/{reseller}/brands/{hostname}/{brand_name}

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

OperationId:GetSpecificBrandFullData

Returns one brand, with every styling field and its assets. Requires Reseller, Super User, or Super User Read Only scope. A Reseller reads only its own brands: any other reseller is a 403.

Brands with the same hostname and name can exist for several domains of the reseller. Send domain (a domain name, or * for the reseller-wide brand) to name the one you mean. Send it in the query.

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 brand.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/resellers//brands/portal.example.com/Blue Theme?domain=*' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Brand

{
    "id": "199c23e1f91546d031eb434db7627cc0",
    "hostname": "portal.example.com",
    "reseller": "example-reseller",
    "domain": "*",
    "brand-name": "Blue Theme",
    "description": "Blue theme for the main portal",
    "currently-active": 1,
    "color-primary": "#1E40AF",
    "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": "rounded",
    "icon-style": "baseline",
    "powered-by": "Powered by Example Company",
    "email-sender": "noreply@example.com",
    "created": "2026-09-01 14:30:00",
    "modified": "2026-09-02 09:15:00",
    "assets": [
        {
            "id": "c8bcb38ef6dee3a921e76350010a3288",
            "brand_id": "199c23e1f91546d031eb434db7627cc0",
            "asset_type": "logo",
            "filename": "logo.png",
            "mime-type": "image/png",
            "width": 200,
            "height": 80,
            "file_size": 45678,
            "created": "2026-09-01 14:30:00",
            "modified": "2026-09-01 14:30:00",
            "download_url": "https://core1.example.com/ns-api/v2/resellers/example-reseller/brands/portal.example.com/Blue+Theme/assets/logo/download"
        },
        {
            "id": "4feee1e3ebcbfb6a1abdcc20187496b4",
            "brand_id": "199c23e1f91546d031eb434db7627cc0",
            "asset_type": "favicon",
            "filename": "favicon.png",
            "mime-type": "image/png",
            "width": 32,
            "height": 32,
            "file_size": 1534,
            "created": "2026-09-01 14:30:00",
            "modified": "2026-09-01 14:30:00",
            "download_url": "https://core1.example.com/ns-api/v2/resellers/example-reseller/brands/portal.example.com/Blue+Theme/assets/favicon/download"
        }
    ]
}

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

Read active reseller brand for hostname

Create reseller brand