Verifications Overview
A Verification is used to retrieve information about an employee's occupation and compensation. The individual requesting the verification is referred to as the Verifier, and the individual who is being verified is referred to as the Target. Truework offers two types of Verifications:
note
Verification of Employment (VOE)#
A report that contains the Target's position, start and end dates at a given employer.
note
Verification of Income (VOI)#
Includes all information provided in a VOE along with the Target's salary and earnings over the last three years.
Terminology#
State#
The state helps convey where the verification request is in the Truework process. It will be returned in the JSON objects returned from this endpoint.
| VALUE | DESCRIPTION |
|---|---|
| pending-approval | The initial state after creation. The Truework team has not started working on this request yet. |
| action-required | A user action is required to continue processing this request. Visit the dashboard for more information. |
| invalid | Contains invalid information that prevents the verification request from being processed by Truework. |
| processing | The Truework team is currently working on the verification request. |
| completed | The verification request has been completed and a report can be found from the reports endpoint. |
| canceled | Truework denied processing of the request or the verifier no longer wants the request to be processed. |
PermissiblePurpose#
A valid purpose is required for Truework to process the verification request.
Throughout the API, this is signified by the permissible_purpose field.
| VALUE | DESCRIPTION |
|---|---|
| child-support | Determine child support payments (available to verifiers that represent a state or local child support enforcement agencies) |
| credit-application | The target's application for credit. |
| employee-eligibility | Employee's eligibility for a benefit granted by a governmental agency required by law to consider the employee's financial responsibility or status. |
| employee-request | The target has issued the verifier written instruction to obtain this information. |
| employee-review-or-collection | Performing a review or collection of the target's account. |
| employment | Employment purposes where the target has given prior written consent. |
| insurance-underwriting-application | Underwriting insurance in response to the target's application. |
| legitimate-reason-initiated | Legitimate business need for the information in connection with a business transaction initiated by the target. |
| legitimate-reason-review | Legitimate business need to review the target's account to determine whether the employee continues to meet the terms of the account. |
| risk-assessment | To assess the credit or prepayment risks associated with an existing credit obligation of the target. |
| subpoena | For a court order or a federal grand jury subpoena. |
Type#
The verification request type is determined by how much information the verifier
wants about the target. Throughout the API, this is signified by the type
field.
| VALUE | DESCRIPTION |
|---|---|
| employment | A verification of employment. The verifier wants information about the target's position, start and end dates at a given employer. |
| employment-income | A verification of income. The verifier wants information about the target's salary and earnings over the last three years in addition to information provided in a VOE |