We’ve extended the List Subscriptions endpoints to return Deal Based subscriptions together with Total Volume subscriptions.

All endpoints for listing subscriptions and Get subscription by the key now return both subscription types. (Deal Based and Total Volume). This means the Commercial API allows you to get everything that belongs to a specified reseller.

Key capabilities:

• Retrieve Deal Based and Total Volume subscriptions together for a given reseller

We’ve extended the documentation with the list of Deal Based product codes.

The documentation now lists the Deal Based product codes that may be returned by the API, in addition to the existing Total Volume codes. We’ve also introduced a fallback product code, W99999, which may be returned for non-commercial products or when a product code cannot be identified from the available data.

For more details, please refer the Commercial API documentation.

We’ve introduced a new endpoint to update the information of a licensee:

Change Company Information

POST /company?existing_buyer_assigned_account_id={existing_buyer_assigned_account_id}

This endpoint allows you to update the details of a licensee, including its name, buyer assigned account ID, and legal entity information (VAT number and postal address).

Key capabilities:

• Update the licensee’s official name
• Update the partner’s internal reference ID (buyer assigned account ID) for the licensee
• Update the licensee’s legal entity information, including VAT number and postal address

For full endpoint details, refer to the API documentation.

We’ve extended the response of the Get Total Volume Resellers endpoint with additional reseller details:

The response now includes new fields for each reseller, giving distributors a richer view of their contracted resellers. In additional to that, Deal Based resellers now returned in the API and can be tracked as well

New fields per reseller:

• total_volume – Indicates whether the reseller has an active Total Volume Frame Agreement allowing to work in the Total Volume model
• deal_based – Indicates whether the reseller has active Partner Deal Terms allowing to act in the Deal Based model
• partner_portal_enabled – Indicates whether the reseller is a Partner Portal user
• address – Reseller’s billing address, including street, city, postal code, state code, and country

Important notes:

• reseller_name and reseller_account_id remain required fields within each reseller entry
• New fields are optional and may not be present for all resellers depends on available data

For full response details, refer to the API documentation.

Updated Documentation: all ‘/subscriptions’ endpoints combined to a single List Subscriptions endpoint with filter parameters


We’ve updated the documentation presentation for the following Commercial API endpoints to align with OpenAPI 3 specification requirements:

• Get subscription by buyer assigned account id
• Get subscription by reseller account id

Both endpoints share the same base URL but differ only by query parameters.
To comply with OpenAPI 3 YAML standards, they are now documented as a single endpoint:
List Subscriptions.

What changed:

• The above endpoints are now combined under List Subscriptions in the documentation
• Query parameters (buyer_assigned_account_id, reseller_account_id) are available as filters within the same endpoint
• Documentation structure updated to meet OpenAPI 3 requirements and improve compatibility with API tools

What did NOT change:

• No changes to endpoint logic or behavior
• No changes to request/response formats
• Existing integrations using:
  • GET /subscriptions?buyer_assigned_account_id={buyer_assigned_account_id}
  • GET /subscriptions?reseller_account_id={reseller_account_id}
    
    continue to work exactly as before

This update is documentation-only and ensures consistent representation of the API without impacting functionality.

We’ve introduced a new endpoint to manage licensee positioning within the Elements Security Center hierarchy:

Change Elements Security Center Hierarchy

POST /hierarchy?buyer_assigned_account_id={buyer_assigned_account_id}

This endpoint is available for Direct Resellers only and allows you to update how a licensee is organized within the hierarchy by assigning it under a specific SEP or SOP in the Elements Security Center only.

Key capabilities:

• Assign a licensee to a specific SEP (if currently under an SOP)
• Assign a licensee to a specific SOP (if currently under an SEP belonging to that SOP)
• Update hierarchy structure without impacting commercial or contractual relationships

Important notes:

• Changes are restricted within the same buyer party
• Cannot be used to move a licensee to another reseller
• SEP and SOP entities must already exist (no creation supported)
• This operation only affects hierarchy structure and display in Elements Security Center and can not be used to move licensee under the new reseller

For full request/response details, refer to the API documentation.

The descriptions for the Create New Subscription and Change Subscription API endpoints were updated to better reflect their purpose and supported operations. No changes were made to request or response parameters.

Documentation-Only Updates to Endpoint Descriptions:

Create New Subscription:

Provision a new Total Volume subscription for a new or existing licensee. This endpoint may also be used to grant access to an admin user in the Elements Security Center or to change the licensee (company) name. Granting access and changing the name can only be completed as part of a subscription creation request.

Change Subscription:

Make changes to an existing Total Volume subscription. This endpoint may also be used to grant access to an admin user in the Elements Security Center as part of a subscription change request.