The Premium Assets V2 API lets you retrieve what a Wix account pays for. A Premium asset is a read-only view of a purchased Premium product, together with the product it came from.
With the Premium Assets V2 API, you can:
It's important to note the following points before starting to code:
targetAccountId
header. Query Premium Assets fails without it.premiumId to identify an asset across calls.Which assets come back depends on what the caller is permitted on, so the same request can return different results for different callers.
A caller permitted on the target account receives all of that account's assets. A caller permitted only on a specific site receives that site's assets alone, because the results are filtered to the site taken from the call scope. A call with neither an account permission nor a site in scope fails.
An account can be the owner of an asset, or a Billing Manager for it, meaning it handles payment for an asset that belongs to someone else.
Query Premium Assets returns owned assets by default. Specify
{"includePermitted": true} to include assets the account only manages billing
for. To work out how many assets fall into each group, call Query Premium Assets
twice and compare the results.
productData.productName and productData.productTypeName are translated to
the language of the request, so they're display values rather than stable
identifiers. Use productData.productId and productData.productTypeId when
you need something stable to compare or store.
productName is returned as an empty string for domains, business email, and
digital goods. For those, use the type-specific fields instead:
domainsData.domain.mailboxesData.domainName.digitalGoodsData.digitalGoodsType.wixBillingDetails.lastInvoiceDetails.amount is a string whose representation
isn't guaranteed to be consistent across billing providers. Some report the
amount in the currency's minor units, for example 950 for 9.50, and others
report a decimal value, for example 9.50. Read
billingReference.providerName to see which billing provider an asset comes
from, and don't assume a single format across assets.
wixBillingDetails.nextInvoiceDetails deliberately carries only a date. The
amount of the next invoice can change before it's issued, for example when tax
changes, so it isn't reported in advance.
freeTrialData.inFreeTrialPeriod is true both during a free trial and while
billing is on hold pending an external activation. Check
freeTrialData.pendingExternalActivation to tell the two apart before showing a
customer that they're in a trial.
Last updated: 23 September 2026