Skip to main content
Employment verification provides multi-year employment history for background screening and pre-employment verification. Truv connects directly to payroll systems, returning verified employer details, dates, and titles in seconds instead of days.

​
Benefits

No Employer Calls

Verified employment directly from payroll systems

Multi-Year History

Complete employment timeline with dates and positions

Candidate Self-Service

Candidates verify on their own device and schedule

Fast Turnaround

Results in seconds instead of days

​
What you get

Data PointDescription
Employer namesVerified company names for each position
Employer addressesPhysical address of each employer
Employment datesStart and end dates for each position
Job titlesPosition titles at each employer
Employment statusActive, terminated, or on leave
Employment gapsPeriods between positions identified automatically

​
Use cases

Verify a candidate’s claimed employment history against payroll records. Confirm employer names, dates, and titles without waiting for HR departments to respond.
Build a complete employment timeline for the candidate, including positions held, duration at each employer, and current status.
Identify periods of unemployment between positions. Useful for compliance requirements that mandate verifying a specific number of years of history.
Confirm that the employers listed by the candidate match payroll records before reaching out for references.

​
Data coverage

​
Payroll Providers

Truv connects to payroll providers covering 85%+ of US employees:
ProviderCoverage
ADP~20% of US workers
Paychex~10% of US workers
WorkdayLarge enterprises
UKG (Kronos)Healthcare, retail
PaylocityMid-market
GustoSmall business
And 100+ more

​
How to implement

Create an order via the Truv API to start an employment verification: 
curl -X POST https://prod.truv.com/v1/orders/ \
  -H "X-Access-Client-Id: YOUR_TRUV_CLIENT_ID" \
  -H "X-Access-Secret: YOUR_TRUV_CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "products": ["employment"],
    "first_name": "Jane",
    "last_name": "Doe",
    "external_user_id": "candidate-123"
  }'
Allow multiple connections for thorough screening. Candidates with several past employers need to connect each one separately through Truv Bridge.

​
Report structure

​
API Response

Retrieve the employment report for a completed link: 
curl https://prod.truv.com/v1/links/{link_id}/employment/report/ \
  -H "X-Access-Client-Id: YOUR_TRUV_CLIENT_ID" \
  -H "X-Access-Secret: YOUR_TRUV_CLIENT_SECRET"
Example response (abbreviated):
FieldPathExample
Active statusemployments[].is_activetrue
Job titleemployments[].job_title"Software Engineer"
Start dateemployments[].start_date"2022-03-15"
Employeremployments[].company.name"Current Company"
{
  "id": "24d7e80942ce4ad58a93f70ce4115f5c",
  "status": "done",
  "provider": "adp",
  "data_source": "payroll",
  "employments": [
    {
      "is_active": true,
      "job_title": "Software Engineer",
      "job_type": "F",
      "start_date": "2022-03-15",
      "original_hire_date": "2022-03-15",
      "end_date": null,
      "company": {
        "name": "Current Company Inc",
        "address": {
          "street": "123 Main St",
          "city": "San Francisco",
          "state": "CA",
          "zip": "94105"
        }
      },
      "profile": {
        "first_name": "Jane",
        "last_name": "Doe"
      }
    }
  ]
}
Each connected employer returns a separate link and employment report. To build a full employment timeline, retrieve the employment report for each link associated with the order.

​
API reference

Orders

Create and manage verification orders

Employment Report

Retrieve employment data

Bridge Token

Create tokens for Truv Bridge

Webhooks

Receive status notifications

​
Best practices

Most background checks require 5-7 years of employment history. Candidates should connect each past employer through Truv Bridge. The employment report for each link includes start dates, end dates, and titles from payroll records.
Candidates with several past employers need to connect each one through Truv Bridge. Each connected employer produces a separate link and employment report.
Not all past employers may be verifiable through payroll. Process available data and flag unverified positions for manual follow-up.

​
Next steps

Embedded Orders

Full implementation walkthrough

Income & Employment

Add income data for tenant screening