Candidate Authenticity
A step-by-step guide on how to verify candidate identity, employment, and income in your application with vouch.
Why Verify Candidate Identity, Employment, and Income?
Candidate Authenticity enables organizations to confirm identity, employment, income, and professional claims using verifiable data from payroll systems, banks, government records, and professional platforms. This verification is critical for several use cases:
- Hiring: Verify candidate credentials, employment history, and income claims during the recruitment process
- Tenant Screening: Confirm applicant identity, employment status, and income to assess rental eligibility
- Lending: Validate borrower identity, employment, and income for loan applications
- Eligibility Checks: Verify professional qualifications and employment status for program eligibility
vouch enables you to verify candidate authenticity by allowing users to prove their identity, employment, and income through authenticated access to their financial accounts, payroll systems, government records, and professional platforms, providing cryptographic proof of their credentials.
See it in action
Watch the video below to see how the Candidate Authenticity verification flow works with Experian Proof of Credit Score. This video demonstrates verifying a user's credit score from their Experian account, proving their financial standing through authenticated access to their Experian account:
Step 1: Select data source
For this Candidate Authenticity example, we'll use Experian Proof of Credit Score as our data source. This data source allows users to verify their identity and credit information by proving access to their Experian account, which contains their verified credit score.
The following tables show available data sources that can help with candidate authenticity verification:
Proof of Employment & Income
Loading data sources...
Proof of Account Ownership - Banking & Finance
Loading data sources...
Proof of Account Ownership - Utilities & Telecom
Loading data sources...
Browse more data sources in the vouch catalog.
Step 2: Redirect users to vouch
To trigger the Candidate Authenticity verification process, redirect the user to vouch to begin the proof generation:
import { Vouch } from '@getvouch/sdk';
const vouch = new Vouch();
const verificationUrl = vouch.getStartUrl({
requestId: crypto.randomUUID(),
datasourceId: "7c2dbaf1-e75e-4dec-a3c1-d1ab71f241a1", // Experian Proof of Credit Score data source
customerId: "1be03be8-5014-413c-835a-feddf4020da2", // Your unique customer ID
redirectBackUrl: `https://docs.getvouch.io/examples/candidate_authenticity`, // Return destination
webhookUrl: `https://docs.getvouch.io/api/web-proof` // Proof delivery endpoint (optional)
});
// Redirect the user to vouch
window.location.href = verificationUrl;This code opens the vouch application in a new tab. The user will complete the Candidate Authenticity verification process by authenticating with their Experian account, and then be redirected back to your application with the verification proof.
Step 3: Understanding the webhook payload
When the Candidate Authenticity verification is complete, vouch sends a POST request to your webhookUrl with the following structure:
{ "requestId": "...", "outputs": { "Credit Score": 809 }, "webProofs": [...]}Payload structure
requestId: The unique ID of the verification requestoutputs: Aggregated extracted and verified results across allwebProofswebProofs: Array of Web Proofs generated for this request. See webProofs structure for more details.
Please note: The webProofs array will be absent when the data source contains sensitive data.
You can pass the presentationJson object to our server for verification. This ensures that the web proof hasn't been tampered with.
Step 4: Test the Candidate Authenticity verification flow
Try the button below to see the complete vouch Candidate Authenticity verification flow in action. This will demonstrate how users verify their identity and credit information using Experian Proof of Credit Score.
Prerequisite
To run Desktop verification flow, install the vouch extension.
Next Steps
Ready to get started? Check out our Getting Started guide to learn how to integrate vouch into your application.