> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/achievement-v1/introduction.md

## Article Content:

# About the Achievements API

The Achievements API lets a Wix partner read their standing in the [Wix Partners Program](https://www.wix.com/studio/partner-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](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/introduction.md).

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](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/achievement-v1/get-overview.md) returns an empty response and [Query Achievements](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/achievement-v1/query-achievements.md) 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](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/achievement-v1/sample-flows.md#display-a-partners-program-standing)
- [Show a partner's achievement breakdown](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/partners-program/achievement-v1/sample-flows.md#show-a-partners-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.

@sdk_package_setup