About the Certifications APIs

The Certifications APIs let you read the Wix Academy certifications held by Wix accounts and by the individual users on them, such as the Velo, Web Designer, and Wix Studio Developer certifications. Users earn these certifications by passing Wix Academy exams or courses. The APIs are read-only: certifications are issued and managed by Wix Academy, so you can retrieve and query them but can't create or change them.

Certifications exist at two levels, each with its own API. A user certification is a certification earned by an individual user. An account certification aggregates those user certifications to the account level: an account holds a certification when one or more of its team members hold the corresponding user certification. Account certifications are the entry point for most reads, and each one references the user certifications, by ID, that qualify the account.

With the Certifications APIs, you can:

• Retrieve any account's certifications for public display, such as certification badges in a partner directory or on a partner's profile.
• Query the full certification records for your own account, including the user certification IDs behind each one.
• Resolve a user certification ID to find out which team member holds a certification.
• Listen to account certification events to keep an external system in sync.

APIs in this category

The Certifications category is made up of two read-only APIs:

API	Reads certifications at	Main entity
Account Certifications	The account level, aggregated across the account's team members.	AccountCertification
User Certifications	The individual user level.	UserCertification

How the two levels fit together

Account certifications are derived from user certifications:

• An account certification is created automatically when a team member earns the first certification of a given type, updated as other team members earn or lose that certification, and deleted when the last team member's certification of that type is removed.
• Each account certification exposes the userCertificationIds that qualify it. Pass one of those IDs to the User Certifications API to find out which team member holds the certification.
• Start from Account Certifications when you want the account-level view, and use User Certifications to resolve an individual holder.

Before you begin

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

• The Certifications APIs are read-only for external developers. Certifications are issued and managed by Wix Academy; you can't create, update, or delete them.
• An account holds each certification type at most once, and a user holds each certification type at most once.
• A certification is permanent once earned and remains valid until it's removed administratively. If a certification exists, you can treat it as currently valid.
• Account certifications update automatically in response to changes in the underlying user certifications and account team membership. These updates are eventually consistent, but typically apply within seconds.
• Reading any account's certifications for public display returns a visitor-safe projection with each certification's type and creation date. Reading the full records, including the underlying user certification IDs, is scoped to your own account.

Use cases

• Display an account's certification badges.
• Sync account certifications with an external system.
• Identify which team members hold a certification.

Terminology

• Account certification: A Wix Academy certification held by an account, backed by one or more certified team members.
• User certification: A Wix Academy certification earned by an individual user, and the building block behind an account certification.