A credential verification validates a candidate's professional credential/license as entered by the candidate.

Certn makes 3-5 sufficient attempts to obtain source data for verification and reports back accordingly. A sufficient attempt can be defined as an attempt which could reasonably lead to a result.

### Availability
This check is available in **Canada** 🇨🇦 and the **US** 🇺🇸  
This check is available for a [**quickscreen**](https://docs.certn.co/api/faq#what-is-a-quickscreen-and-how-do-i-use-it)✅

| Industry              | Availability | Endpoints                                  |
|-----------------------|--------------|--------------------------------------------|
| Human Resources       | Yes          | - [Quickscreen](https://docs.certn.co/api/api-reference/hr#screen-an-applicant-instantly)✅  
|                       |              | - [Invite](https://docs.certn.co/api/api-reference/hr#invite-an-applicant)📩             |
| Property Management    | No           | - Quickscreen ❌                          |
|                       |              | - Invite ❌                               |

### Parameters

#### Request flag
Include this flag in the body of your request:

[`request_credential_verification`](https://docs.certn.co/api/api-reference/resources/application-parameters/request-flags)

#### Optional flags
Set these flags explicitly, or leave them out to use your team's default settings:

- `credential_verification_level`
- `credential_verification_min`
- `credential_verification_max`

See all [Credential Verification flags](https://docs.certn.co/api/api-reference/resources/application-parameters/request-flags#credential-verification-flags).

#### Invite parameters
To invite an applicant to complete a screen, include this parameter in the body of your request:
- `email`

See all available [Application parameters](https://docs.certn.co/api/api-reference/resources/application-parameters)

#### Quickscreen parameters
To complete a quickscreen, include these parameters in the body of your request:
- [`information`](https://docs.certn.co/api/api-reference/resources/application-parameters#information)
  - `first_name`
  - `last_name`
  - `date_of_birth`
  - [`addresses`](https://docs.certn.co/api/api-reference/resources/application-parameters#address) (min 1)
  - [`credentials`](https://docs.certn.co/api/api-reference/resources/application-parameters#credential) (min 1)
- [`position_or_property_location`](https://docs.certn.co/api/api-reference/resources/application-parameters#specialization)

Make sure to obtain the [proof of consent](https://docs.certn.co/api/guides/use-the-api/consent) from your applicant **before** running the quickscreen.

**Example request**

```json
{
    "request_credential_verification": true,
    "email": "example@certn.co",
    "information": {
        "first_name": "Sebastien",
        "last_name": "Normandin",
        "date_of_birth": "1970-06-28",
        "addresses": [{
                "address": "4412 King Alfred Court",
                "city": "Victoria",
                "province_state": "BC",
                "country": "CA",
                "current": true
            }
        ],
        "credentials": [{
                "date_of_certification": "2020-08-21",
                "description": "PMP proves project leadership experience and expertise.",
                "certification": "Project Management Professional (PMP)",
                "institution": "Project Management Institute",
                "current": false
            }
        ]
    },
    "position_or_property_location": {
        "address": "Tiffany & Co., 97 Greene St",
        "city": "New York City",
        "county": "New York",
        "province_state": "NY",
        "country": "US",
        "postal_code": "10012",
        "location_type": "Position Location"
    }
}
```

### Report
Report field: `information.credentials`

Each credential verification object can be found under `information.credentials[index]`. See [Certn Verifications](https://docs.certn.co/api/api-reference/resources/report-field-mappings#certn-verifications) for more.