About the Account Details API

With the Account Details API you can retrieve key information about a site's email marketing account, including the account's current status, premium plan details, and email quota for the current billing period.

With the Account Details API, you can retrieve:

• The account's current status and whether campaigns can be sent.
• The current premium plan and its monthly quota allocation.
• Quota usage for the current billing period.

Account status

The account status field indicates whether the site can send email marketing campaigns. An account must be ACTIVE before campaigns can be sent.

Possible statuses:

• ACTIVE: The account is in good standing. Campaigns can be created and sent.
• WARNED: The account owner must accept the terms of use in the Wix Email Marketing dashboard before campaigns can be sent.
• SUSPENDED: The account is suspended. The account owner must complete a compliance questionnaire in the Wix Email Marketing dashboard.
• SUSPENDED_AUTOLIFT: The account is suspended but may be automatically reinstated after completing a compliance questionnaire in the Wix Email Marketing dashboard.
• BANNED: The account is suspended. The account owner must complete a more rigorous compliance questionnaire in the Wix Email Marketing dashboard.

When the status is not ACTIVE, campaigns cannot be sent. Resolution requires the site owner to visit the Wix Email Marketing dashboard. There is no public API for changing account status.

Quota

The quotaPeriod field shows the current billing cycle and how much quota has been used:

• quotaPeriod.dateFrom and quotaPeriod.dateTo: the start and end of the current quota period. Quota always resets on a monthly cycle, regardless of whether the site has a monthly or yearly billing plan.
• quotaPeriod.quotaUsage: campaigns and emails sent so far in this period.
• package.monthlyQuotaAllocation: the maximum campaigns and emails allowed per quota period. A campaigns value of -1 means unlimited campaigns.

Before you begin

It's important to note the following points before starting to code:

• The Account Details API is read-only. Use Get Account Details to check account status and quota before publishing campaigns.
• When the account status is not ACTIVE, the site owner must resolve the issue in the Wix Email Marketing dashboard. There is no public API for changing account status.
• Quota is tracked per billing period. Exceeding the email quota prevents additional campaigns from being sent until the quota resets.

Use cases

• Check account eligibility before sending a campaign

Terminology

• Account status: Indicates whether the site's email marketing account is active and campaigns can be sent. Possible values: ACTIVE, WARNED, SUSPENDED, SUSPENDED_AUTOLIFT, BANNED.
• Quota period: The current billing cycle, defined by dateFrom and dateTo, during which the allocated quota applies.
• Monthly quota allocation: The maximum number of campaigns and emails the current plan allows per billing period. A value of -1 means unlimited.
• Package group: A set of Wix premium plans that share compatible quota allocations and can be upgraded or downgraded between each other.