> 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

# GetUserCertification

# Package: certifications

# Namespace: UserCertifications

# Method link: https://dev.wix.com/docs/api-reference/account-level/studio-workspace/certifications/user-certification-v1/get-user-certification.md

## Introduction

Retrieves a user certification.

---

## REST API

### Schema

```
 Method: getUserCertification
 Description: Retrieves a user certification.
 URL: https://www.wixapis.com/academy/certifications/v1/user-certifications/{userCertificationId}
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  userCertificationId
 Method parameters: 
   param name: userCertificationId | type:   none | required: true 
 Return type: GetUserCertificationResponse
  - name: userCertification | type: UserCertification | description: Retrieved user certification.  
     - name: id | type: string | description: User certification GUID.  | validation: format GUID
     - name: revision | type: string | description: Revision number, which increments by 1 each time the user certification is updated. To prevent conflicting changes, the current revision must be passed when updating the user certification.  Ignored when creating a user certification.  | validation: format int64
     - name: createdDate | type: string | description: Date and time the user certification was created.  | validation: format date-time
     - name: updatedDate | type: string | description: Date and time the user certification was last updated.  | validation: format date-time
     - name: userId | type: string | description: GUID of the certified user. Set when the certification is created and can't be changed afterward.  | validation: format GUID, immutable
     - name: certificationType | type: CertificationType | description: Type of certification the user holds. Set when the certification is created and can't be changed afterward.  | validation: immutable
         - enum:
         -     VELO: Velo certification: proficiency in building with Velo, Wix's full-stack development platform.
         -     WEB_DESIGNER: Web Designer certification: proficiency in designing and building Wix websites.
         -     ACCESSIBILITY: Accessibility certification: proficiency in building accessible Wix websites.
         -     STUDIO_DEVELOPER: Wix Studio Developer certification: proficiency in developing with Wix Studio.
         -     STUDIO_DESIGN_LEAGUE: Wix Studio Design League certification, awarded through the Wix Studio Design League program.
         -     STUDIO_DEV_WEBSITES_LEAGUE: Wix Studio Developer Websites League certification, awarded through the Wix Studio Developer Websites League program.


```

### Examples

### Get User Certification
Retrieves a user certification by ID

```curl
curl -X GET \
'https://www.wixapis.com/academy/certifications/v1/user-certifications/d7a341c4-196b-46e7-813c-2b0fc1847ec6' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.userCertifications.userCertifications.getUserCertification(userCertificationId)
 Description: Retrieves a user certification.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  userCertificationId
 Method parameters: 
   param name: userCertificationId | type: string | description: GUID of the user certification to retrieve. | required: true | validation: format GUID
 Return type: PROMISE<UserCertification>
  - name: _id | type: string | description: User certification GUID.  | validation: format GUID
  - name: revision | type: string | description: Revision number, which increments by 1 each time the user certification is updated. To prevent conflicting changes, the current revision must be passed when updating the user certification.  Ignored when creating a user certification.  | validation: format int64
  - name: _createdDate | type: Date | description: Date and time the user certification was created.  
  - name: _updatedDate | type: Date | description: Date and time the user certification was last updated.  
  - name: userId | type: string | description: GUID of the certified user. Set when the certification is created and can't be changed afterward.  | validation: format GUID, immutable
  - name: certificationType | type: CertificationType | description: Type of certification the user holds. Set when the certification is created and can't be changed afterward.  | validation: immutable
     - enum:
     -     VELO: Velo certification: proficiency in building with Velo, Wix's full-stack development platform.
     -     WEB_DESIGNER: Web Designer certification: proficiency in designing and building Wix websites.
     -     ACCESSIBILITY: Accessibility certification: proficiency in building accessible Wix websites.
     -     STUDIO_DEVELOPER: Wix Studio Developer certification: proficiency in developing with Wix Studio.
     -     STUDIO_DESIGN_LEAGUE: Wix Studio Design League certification, awarded through the Wix Studio Design League program.
     -     STUDIO_DEV_WEBSITES_LEAGUE: Wix Studio Developer Websites League certification, awarded through the Wix Studio Developer Websites League program.


```

### Examples

### Get a user certification
```javascript
import { userCertifications } from "@wix/user-certifications";

async function getUserCertification() {
  const userCertificationId = "d7a341c4-196b-46e7-813c-2b0fc1847ec6";

  const userCertification =
    await userCertifications.getUserCertification(userCertificationId);

  return userCertification;
}

/* Promise resolves to:
 * {
 *   "_id": "d7a341c4-196b-46e7-813c-2b0fc1847ec6",
 *   "revision": "1",
 *   "_createdDate": "2024-01-15T10:30:00.000Z",
 *   "_updatedDate": "2024-01-15T10:30:00.000Z",
 *   "userId": "5a8b1f2c-3d4e-4f6a-8b9c-0d1e2f3a4b5c",
 *   "certificationType": "VELO"
 * }
 */

```

### getUserCertification (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { userCertifications } from '@wix/user-certifications';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { userCertifications },
  // Include the auth strategy and host as relevant
});


async function getUserCertification(userCertificationId) {
  const response = await myWixClient.userCertifications.getUserCertification(userCertificationId);
};
```

---