About the Achievements API

The Achievements API lets a Wix partner read their standing in the Wix Partners Program, including their level, points, and the achievements that earn those points.

Partners earn points through achievements, such as holding a premium subscription on a site they manage or completing a Wix certification. The sum of a partner's achievement points determines their program level, and each level unlocks additional benefits.

For more information about the broader Partners Program APIs, see About the Partners Program APIs.

With the Achievements API, you can:

• Retrieve a partner's program overview, including their current level, total points, and the points remaining to reach the next level.
• Retrieve and query a partner's achievements, including the points each achievement contributes and how it was earned.

Levels

A partner's level is determined by their total achievement points:

• PIONEER: Fewer than 1000 points.
• CREATOR: 1000 to 1999 points.
• ICON: 2000 to 4999 points.
• LEGEND: 5000 or more points.

The overview's nextLevel field shows the next level up and how many more points the partner needs to reach it. It's returned for every level except LEGEND, which is the highest.

Before you begin

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

• Both endpoints return data for the calling account only. The account is derived from the request's identity, so a partner can read their own program data but not another partner's.
• The account must be a member of the Partners Program. If it isn't, Get Overview returns an empty response and Query Achievements returns no achievements.
• Achievements are created by Wix based on partner activity. This API is read only, so you can't create, update, or delete achievements through it.

Use cases

• Display a partner's program standing
• Show a partner's achievement breakdown

Terminology

• Partner: A Wix user enrolled in the Wix Partners Program.
• Achievement: A single accomplishment a partner has earned, worth a set number of points. Each achievement records how it was earned, such as a premium subscription or a certification.
• Points: The value an achievement contributes toward a partner's level. A partner's total points are the sum of the points from all their achievements.
• Level: A partner's tier in the program, determined by their total points. Higher levels unlock additional benefits.