# About the Account Certifications API

The Account Certifications API lets you read the Wix Academy certifications held by an account,
such as the Velo, Web Designer, and Wix Studio Developer certifications.
An account holds a certification when one or more of its team members hold the corresponding
user certification.

With the Account Certifications API, you can:

- Retrieve any account's certifications for public display, returning each certification's type and creation date.
- Query the certifications held by your own account, filtering and sorting by certification type.
- Listen to account certification events to keep an external system in sync.

## Reading account certifications

Choose the endpoint that matches whose certifications you need and how much detail you want:

- **List Account Certifications** takes an account ID and returns a public, visitor-safe projection
  of any account's certifications, containing each certification's type and creation date. Use it to
  display certification badges, for example in a partner directory or on a partner's profile.
- **Query Account Certifications** returns the full account certification records, including the
  underlying user certification IDs, for your own account only. Use it when you need the complete
  records, for example to sync certifications into an external system. To find out which team member
  holds each certification, pass a returned ID to [Get User Certification](fallback::https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/user-certification-v1/get-user-certification).

## Before you begin

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

- Certifications are managed by Wix. For external developers this API is read-only: you can retrieve and query certifications, but you can't create, update, or delete them.
- An account certification is derived from user certifications. It's 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. An account also loses a team member's certifications when that member is removed from the account.
- 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.
- An account holds each certification type at most once. Each account certification aggregates all of the account's team members who hold the corresponding user certification.
- A certification is permanent once earned and remains valid until it's removed administratively.

## Use cases

- [Display an account's certification badges](fallback::https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/account-certification-v1/sample-flows#display-an-accounts-certification-badges)
- [Sync account certifications with an external system](fallback::https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/account-certification-v1/sample-flows#sync-account-certifications-with-an-external-system)

## 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.
- **Certification type**: The specific certification held, such as Velo or Web Designer.

## See also

- [User Certifications API](fallback::https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/user-certification-v1/introduction): Read certifications at the individual user level. Resolve a `userCertificationId` to find out which team member holds a certification.

@sdk_package_setup

# Account Certifications: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

## Display an account's certification badges

To show a "Wix Certified" badge or a list of certifications for an account, for example in a partner
directory or on a partner's profile:

1. Call [List Account Certifications](fallback::https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/account-certification-v1/list-account-certifications) with the account's ID.
1. For each returned certification, read `certificationType` to display the certifications the account holds.
1. Optionally use `createdDate` to show when each certification was earned.

Coding Examples

Sled Tests

Go Headless

Develop Websites (SDK)

Build Apps

Client (Deprecated)

API Preview

Wix CLI

Ricos

Develop Websites

API Reference

Velo

Picasso

GraphQL (Alpha)

ID of the Wix account associated with the event.

accountId

ID of the parent Wix account. Only included when accountId belongs to a child account.

parentAccountId

ID of the Wix site associated with the event. Only included when the event is tied to a specific site.

siteId

AccountInfo

identityType

IdentificationData

WebhookIdentityType

ID of a site visitor that has not logged in to the site.

anonymousVisitorId

appId

ID of a site visitor that has logged in to the site.

memberId

ID of a Wix user (site owner, contributor, etc.).

wixUserId

data

eventType

The identification type and identity data.

instanceId

MessageEnvelope

value

BoolValue

Empty

Int32Value

Int64Value

values

ListValue

NullValue

StringValue

fields

Struct

nanos

seconds

Timestamp

Value

boolValue

listValue

nullValue

numberValue

stringValue

structValue

kind

An account certification represents a Wix Academy certification held by an account,
such as the Velo, Web Designer, or Wix Studio Developer certification.

An account holds a certification when one or more of its team members hold the corresponding
user certification. Each account has at most one account certification per certification type,
aggregating all of the account's certified team members for that type.

To read certifications at the individual user level, see the User Certifications API.

Type of certification the account holds. Set when the certification is created and can't be changed afterward.

certificationType

Date and time the account certification was created.

createdDate

Revision number, which increments by 1 each time the account certification is updated.
To prevent conflicting changes,
the current revision must be passed when updating the account certification.

Ignored when creating an account certification.

revision

Date and time the account certification was last updated.

updatedDate

IDs of the user certification records, held by the account's team members, that qualify the
account for its `certificationType`. Up to 100. The list contains no duplicates, and its order isn't guaranteed.

userCertificationIds

AccountCertification

A public, visitor-safe view of a certification held by an account.

Certification

ID of the user certification to add to the account.

userCertificationId

CertifyAccountRequest

The created or updated account certification.

CertifyAccountResponse

ID of the user certification to remove from the account.

DecertifyAccountRequest

Updated account certification. Empty when the last user certification of that type was removed and the account certification was deleted.

DecertifyAccountResponse

ID of the account to get certifications for.

ListAccountCertificationsRequest

The account's certifications, as a public, visitor-safe projection.

certifications

ListAccountCertificationsResponse

Query options. See [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language) for more information.

QueryAccountCertificationsRequest

accountCertifications

QueryAccountCertificationsResponse

ID of the account the user was removed from.

ID of the user (team member) that was removed from the account. Same identifier as `UserCertification.userId`.

teamMemberId

TeamMemberRemovedEvent

Pointer to the next or previous page in the list of results.

You can get the relevant cursor token
from the `pagingMetadata` object in the previous call's response.
Not relevant for the first request.

cursor

limit

CursorPaging

Number of items returned in the response.

count

Indicates if there are more results after the current page.
If `true`, another page of results can be retrieved.
If `false`, this is the last page.

hasNext

CursorPagingMetadata

Cursor pointing to next page in the list of results.

Cursors

SortOrder

fieldName

order

Sorting

Filter object in the following format:
`"filter" : {
"fieldName1": "value1",
"fieldName2":{"$operator":"value2"}
}`
Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`

filter

Sort object in the following format:
`[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`

sort

CursorQuery

Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`.

pagingMethod

Velo certification: proficiency in building with Velo, Wix's full-stack development platform.

Web Designer certification: proficiency in designing and building Wix websites.

Accessibility certification: proficiency in building accessible Wix websites.

Wix Studio Developer certification: proficiency in developing with Wix Studio.

Wix Studio Design League certification, awarded through the Wix Studio Design League program.

Wix Studio Developer Websites League certification, awarded through the Wix Studio Developer Websites League program.

CertificationType

bodyAsJson

ActionEvent

A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at `16:00` and then again at `16:01`, the second update will always have a higher sequence number.
You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.

entityEventSequence

Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.

entityFqdn

ID of the entity associated with the event.

entityId

Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`.

eventTime

Event ID. With this ID you can easily spot duplicated events and ignore them.

If present, indicates the action that triggered the event.

originatedFrom

Event action name, placed at the top level to make it easier for users to dispatch messages.
For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.

slug

Whether the event was triggered as a result of a privacy regulation application
(for example, GDPR).

triggeredByAnonymizeRequest

DomainEvent

body

entityAsJson

Indicates the event was triggered by a restore-from-trashbin operation for a previously deleted entity

EntityCreatedEvent

deletedEntityAsJson

EntityDeletedEvent

Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.

currentEntityAsJson

EntityUpdatedEvent

deletedDate

RestoreInfo

query

Retrieves a list of up to 1,000 account certifications, given the provided paging, filtering, and sorting.

Query Account Certifications returns the full account certification records, including the underlying `userCertificationIds`, for the caller's own account only. To retrieve any account's certifications as a public, visitor-safe projection, call [List Account Certifications](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/account-certification-v1/list-account-certifications) instead.

Query Account Certifications runs with these defaults, which you can override:

- `createdDate` is sorted in `DESC` order
- `cursorPaging.limit` is `50`

You can filter and sort by `id` and `certificationType`.

To learn about working with Query methods, see [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language), [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging), and [Field Projection](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-field-projection).

Retrieves the certifications held by your own account, filtered by certification type

Query Account Certifications

QueryAccountCertifications

SCOPE.ACADEMY.ACCOUNT_CERTIFICATION_READ

Retrieves an account's certifications for public display, given the account ID.

This is a public, visitor-safe projection that returns only each certification's type and
creation date. To retrieve the full account certification records, including the underlying
`userCertificationIds`, call [Query Account Certifications](https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/account-certification-v1/query-account-certifications) instead.

Retrieves an account's certifications for public display, given the account ID