Vouch logovouch
Examples

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 request
  • outputs: Aggregated extracted and verified results across all webProofs
  • webProofs: 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.

Candidate Authenticity | vouch Docs