> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Employment for Screening

> Employment history verification for background checks

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

<CardGroup cols={2}>
  <Card title="No Employer Calls" icon="phone-slash">Verified employment directly from payroll systems</Card>
  <Card title="Multi-Year History" icon="calendar">Complete employment timeline with dates and positions</Card>
  <Card title="Candidate Self-Service" icon="face-smile">Candidates verify on their own device and schedule</Card>
  <Card title="Fast Turnaround" icon="bolt">Results in seconds instead of days</Card>
</CardGroup>

***

## What you get

| Data Point             | Description                                        |
| ---------------------- | -------------------------------------------------- |
| **Employer names**     | Verified company names for each position           |
| **Employer addresses** | Physical address of each employer                  |
| **Employment dates**   | Start and end dates for each position              |
| **Job titles**         | Position titles at each employer                   |
| **Employment status**  | Active, terminated, or on leave                    |
| **Employment gaps**    | Periods between positions identified automatically |

***

## Use cases

<AccordionGroup>
  <Accordion title="Pre-employment background checks" icon="clipboard-check">
    Verify a candidate's claimed employment history against payroll records. Confirm employer names, dates, and titles without waiting for HR departments to respond.
  </Accordion>

  <Accordion title="Employment history verification" icon="building">
    Build a complete employment timeline for the candidate, including positions held, duration at each employer, and current status.
  </Accordion>

  <Accordion title="Gap analysis" icon="magnifying-glass">
    Identify periods of unemployment between positions. Useful for compliance requirements that mandate verifying a specific number of years of history.
  </Accordion>

  <Accordion title="Reference checking" icon="users">
    Confirm that the employers listed by the candidate match payroll records before reaching out for references.
  </Accordion>
</AccordionGroup>

***

## Data coverage

### Payroll Providers

Truv connects to payroll providers covering 85%+ of US employees:

| Provider      | Coverage            |
| ------------- | ------------------- |
| ADP           | \~20% of US workers |
| Paychex       | \~10% of US workers |
| Workday       | Large enterprises   |
| UKG (Kronos)  | Healthcare, retail  |
| Paylocity     | Mid-market          |
| Gusto         | Small business      |
| And 100+ more |                     |

***

## How to implement

Create an order via the Truv API to start an employment verification:

```bash theme={null}
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"
  }'
```

<Tip>
  **Allow multiple connections for thorough screening.** Candidates with several past employers need to connect each one separately through Truv Bridge.
</Tip>

***

## Report structure

### API Response

Retrieve the employment report for a completed link:

```bash theme={null}
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):

| Field         | Path                         | Example               |
| ------------- | ---------------------------- | --------------------- |
| Active status | `employments[].is_active`    | `true`                |
| Job title     | `employments[].job_title`    | `"Software Engineer"` |
| Start date    | `employments[].start_date`   | `"2022-03-15"`        |
| Employer      | `employments[].company.name` | `"Current Company"`   |

<Accordion title="View full response example" icon="code">
  ```json theme={null}
  {
    "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"
        }
      }
    ]
  }
  ```
</Accordion>

<Info>
  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.
</Info>

***

## API reference

<CardGroup cols={2}>
  <Card title="Orders" icon="file-circle-plus" href="/api-reference/orders/object">Create and manage verification orders</Card>
  <Card title="Employment Report" icon="building" href="/api-reference/account-link-income-and-employment-reports/link_detail_reports_employment">Retrieve employment data</Card>
  <Card title="Bridge Token" icon="key" href="/api-reference/bridge-token/object">Create tokens for Truv Bridge</Card>
  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks">Receive status notifications</Card>
</CardGroup>

***

## Best practices

<AccordionGroup>
  <Accordion title="Request 5-7 years of history" icon="calendar">
    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.
  </Accordion>

  <Accordion title="Allow multiple connections" icon="building">
    Candidates with several past employers need to connect each one through Truv Bridge. Each connected employer produces a separate link and employment report.
  </Accordion>

  <Accordion title="Process partial results" icon="circle-half-stroke">
    Not all past employers may be verifiable through payroll. Process available data and flag unverified positions for manual follow-up.
  </Accordion>
</AccordionGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Embedded Orders" icon="code" href="/screening/integration/embedded-orders">
    Full implementation walkthrough
  </Card>

  <Card title="Income & Employment" icon="money-bill-trend-up" href="/screening/products/income-employment">
    Add income data for tenant screening
  </Card>
</CardGroup>