# Employment Verification

An employment verification validates the details of disclosed employment history of an individual for a specified year period (3, 5, or 7). Current employers are contacted only if given permission to do so. The components verified could include position held and dates of employment and will depend on availability of data within an entity's records. Income verification is also obtained for non-employment purposes only.

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. Additional fees can apply when an employer utilizes an outsourced entity to provide data.

## Availability
This check is available in **Canada** 🇨🇦 and the **US** 🇺🇸.

This check is not available for a [quickscreen](https://docs.certn.co/api/certn-api-v-1.0/faq#what-is-a-quickscreen-and-how-do-i-use-it) ❌.

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

## Parameters

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

[`request_employment_verification`](https://docs.certn.co/api/certn.co/api-reference/resources/application-parameters/request-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/certn.co/api-reference/resources/application-parameters).

**Example request**

```json
{
    "request_employment_verification": true,
    "email": "example@certn.co"
}
```

## Report
Report field: [`information.employers`](https://docs.certn.co/api/certn.co/api-reference/resources/report-field-mappings#certn-verifications)

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