Skip to content
FinHubBy HabileLabs

Employment Verification

Verify a candidate's past employment history for reliable, auditable background checks.

request · /v1/employment/verify

Candidate pan

Employer name

Send request

api · POST /v1/kyc/verify
POST /v1/kyc/verify
Authorization: Bearer sk_live_••••
{ "pan": "XXXXXXXXXX", "consent_artifact": "ca_••••" }
OKVerified
{
"status": "verified",
"name_match": "high",
"dpdp_purpose_code": "LOAN_KYC",
"consent": "sealed"
}

Overview

What the Employment Verification API Does

The Employment Verification API retrieves and validates a candidate's employment history, confirming employer names, tenure, and designation against available records. BFSI HR and vendor-management teams use it to run consistent background checks before hiring or onboarding third-party staff.

Inputs

  • Candidate pan
  • Employer name
  • Consent artefact id

Returns

  • Employment history
  • Employer name
  • Tenure
  • Designation
  • Verification status

POST /v1/employment/verify

How it works

Three Steps to a Verified Result

01

Submit the candidate's

Submit the candidate's PAN with a valid consent artefact, optionally naming a specific employer to confirm.

02

FinHub cross-checks available

FinHub cross-checks available employment records to verify tenure, designation, and employer details.

03

A structured employment

A structured employment history is returned, with the check logged to a tamper-evident audit trail.

Use cases

Where Teams Use Employment Verification

  • Pre-hire background checks for BFSI employees and contractors
  • Verifying employment claims on loan and credit-card applications
  • Vendor and gig-worker onboarding due diligence
  • Re-verifying employment for periodic KYC refresh cycles

FAQ

Employment Verification API, FAQs

Common questions about FinHub's Employment Verification API.

Yes. Every employment verification request must include a valid consent artefact from the candidate before any data is returned.

More verification APIs

Explore Related APIs

Ready to Add Employment Verification to Your Flow?

Book a demo and see the API return a verified result on your own test data in minutes.