# Get Banners (deprecated)

Retrieves entitlement banner notifications for the authenticated tenant. This method will be removed no sooner than 08/31/2026. The following endpoint /entitlements/banners/query can be used for this content.

Endpoint: GET /banners
Version: v0.2.0

## Query parameters:

  - `type` (string)
    Filter by device type (Optional). If device agnostic sku feature is enabled, all device types will be treated as APSW except ANALYTICS.
    Enum: "IOT_CTRL", "UNASSIGNED_DEVICE_TYPE", "WIFI", "LTE", "SWITCH", "ANALYTICS", "RWG", "EDGE", "VIRTUAL_EDGE", "APSW", "EDGE_SECS", "EDGE_SECL", "SLTN_PIN_FOR_IDENTITY", "SLTN_TOKEN", "SLTN_PMS_INTEGRATION"

  - `licenseType` (string)
    Filter by license type (optional)
    Enum: "UNKNOWN", "APSW", "URLF", "EDGE_SECS", "EDGE_SECL", "SLTN_TOKEN"

## Response 200 fields (application/json):

  - `alm` (boolean)
    Indicates whether this banner is related to ALM (advanced license management) features and functionality.

  - `almExtraInfo` (object)
    Additional ALM entitlement information including license types, quantities, and remaining capacity for advanced license management scenarios.

  - `almExtraInfo.licenseType` (string)
    Type of license in the ALM system, categorizing the specific license classification for entitlement management.
    Enum: "UNKNOWN", "APSW", "URLF", "EDGE_SECS", "EDGE_SECL", "SLTN_TOKEN"

  - `almExtraInfo.remainingQuantity` (integer)
    Remaining license quantity available for this license type, indicating how many licenses are still unused or unassigned.

  - `almExtraInfo.soEntQuantity` (integer)
    Total licensed daily device count in the sales order, representing the complete entitlement quantity from the original sales order.

  - `deviceCount` (integer)
    Total number of devices covered by the license associated with this banner, representing licensed device capacity.

  - `deviceSubType` (string)
    Specific subtype or model classification within the broader device type category, providing more granular device identification.

  - `deviceType` (string)
    Type of devices covered by this license banner, such as access points, switches, or analytics devices.
    Enum: "IOT_CTRL", "UNASSIGNED_DEVICE_TYPE", "WIFI", "LTE", "SWITCH", "ANALYTICS", "RWG", "EDGE", "VIRTUAL_EDGE", "APSW", "EDGE_SECS", "EDGE_SECL", "SLTN_PIN_FOR_IDENTITY", "SLTN_TOKEN", "SLTN_PMS_INTEGRATION"

  - `effectDate` (string)
    The effective date when the license condition described in this banner takes effect, such as expiration date or grace period end.

  - `effectDays` (integer)
    Number of days until the effective date is reached, providing countdown information for license expiration or other time sensitive conditions.

  - `licenseType` (string)
    License type classification indicating the specific licensing model or category applicable to this banner notification.
    Enum: "UNKNOWN", "APSW", "URLF", "EDGE_SECS", "EDGE_SECL", "SLTN_TOKEN"

  - `multipleLicense` (boolean)
    Indicates whether multiple license types or entitlements are involved in this banner notification scenario.

  - `totalActiveDevices` (integer)
    Total count of currently active devices across all device types including access points, switches, and edge devices.

  - `totalRALicense` (integer)
    Total number of ruckus analytics licenses available, for tracking and notifications.

  - `type` (string)
    Enum: "INITIAL", "CLOSE_TO_EXPIRATION", "GRACE_PERIOD", "AFTER_GRACE_PERIOD", "RA_BELOW_90_PERCENT_OF_DEVICES", "RA_BELOW_50_PERCENT_OF_DEVICES", "RA_ONBOARD_ONLY"