---
title: "Retrieve an employment history report for a link"
method: GET
path: "/v1/links/{link_id}/employment/report/"
tags: ["Reports"]
---

# Retrieve an employment history report for a link

`GET /v1/links/{link_id}/employment/report/`

The endpoint returns the VOE report for a link

## Response `200`

- EmploymentCheck — Data for the employment verification
  - `id` string, required — Unique ID
  - `status` string, required — [Request status](https://docs.truv.com/reference/task-livecycle)
  - `finished_at` string, required — Time when report was finished
  - `completed_at` string, required — Time when report was completed **(Deprecated, invalid datetime format)**
  - `access_token` string, required — Access token for a Link to payroll provider
  - `tracking_info` string, nullable, required — Any information passed to the Truv Bridge from a partner
  - `is_suspicious` boolean — Flag to indicate if the data from the source is suspicious. E.g. fraud detected in uploaded documents or SSN of the user does not match with the data
  - `employments` Employment[], required — List of employments received from a payroll provider
    - `id` string, required — Unique ID
    - `is_active` boolean, nullable — Indicates whether the employment is still active
    - `job_title` string, nullable — Employee's job title
    - `job_type` 'F' | 'P' | 'S' | 'D' | 'C' | 'V' | 'null', nullable — Employee's job type: * `F` - Full Time, * `P` - Part Time, * `S` - Seasonal, * `D` - Daily (per diem), * `C` - Contract, * `V` - Volunteer
    - `start_date` string, date, nullable — Employee's hire date
    - `original_hire_date` string, date, nullable — Original hire date
    - `end_date` string, date, nullable — Employee's end date
    - `external_last_updated` string, date, nullable — Indicates the date when employment data was last updated on the Payroll Provider side
    - `dates_from_statements` boolean — Indicates whether or not the Employee's hire and/or end dates were derived from first/last pay statements **(Deprecated)**
    - `derived_fields` string[] — Array of derived fields
    - `missing_data_fields` string[] — List of the data fields which are missing in the payroll API response
    - `manager_name` string, nullable — Supervisor's name
    - `profile` Profile, required — Person's identity information
      - `id` string — ID of the object
      - `created_at` string — Person's identity info was retrieved first time (ISO 8601)
      - `updated_at` string — Person's identity info was retrieved last time (ISO 8601)
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `full_name` string, nullable — Full name
      - `middle_initials` string, nullable — Middle initials
      - `email` string, email, nullable — Email address. Normalized to lowercase.
      - `ssn` string, nullable — Social security number — either the full 9 digits or the last 4 digits, depending on what the data source exposes. Digits only, never formatted with dashes.
      - `date_of_birth` string, date, nullable — Date of birth
      - `home_address` object, nullable — Home address
        - `street` string — Street address as provided by the data source. May contain multiple lines separated by `\n` (address line 1 and line 2).
        - `city` string — City as provided by the data source.
        - `state` string — State or region. For US addresses this is typically a 2-letter state code; some data sources return a full state name, an empty string, or omit the key. Non-US regions are returned as provided.
        - `zip` string — Postal code as provided by the data source. Typically a 5-digit US ZIP code; ZIP+4 (`94105-1804`), 9 digits without a separator, and non-US postal codes also occur.
        - `country` string — 2-letter ISO 3166-1 alpha-2 country code. Defaults to `US` when the data source does not specify a country.
    - `company` Company, required — Company information
      - `name` string, required — Company name. Common legal suffixes (LLC, Inc, Corp, and similar) are stripped during normalization.
      - `address` object, required — Company address
        - `street` string — Street address as provided by the data source. May contain multiple lines separated by `\n` (address line 1 and line 2).
        - `city` string — City as provided by the data source.
        - `state` string — State or region. For US addresses this is typically a 2-letter state code; some data sources return a full state name, an empty string, or omit the key. Non-US regions are returned as provided.
        - `zip` string — Postal code as provided by the data source. Typically a 5-digit US ZIP code; ZIP+4 (`94105-1804`), 9 digits without a separator, and non-US postal codes also occur.
        - `country` string — 2-letter ISO 3166-1 alpha-2 country code. Defaults to `US` when the data source does not specify a country.
      - `phone` string, nullable — Company phone number as provided by the data source. Contains digits and may include `,`, `*`, or `#` for extensions. Usually 10 digits, but a country-code prefix (11-digit `1XXXXXXXXXX`) or an extension can make it longer. Never formatted with punctuation or spaces.
      - `ein` string, nullable — Employer Identification Number (EIN) as provided by the data source. Usually 9 digits with no separator; never formatted with dashes. Some payroll providers supply values that contain letters.
  - `pdf_report` string, uri — Verification report in PDF format
  - `provider` string, required — Payroll provider name
  - `data_source` 'payroll' | 'docs' | 'financial_accounts' — Source of data: crawler - payroll provider parsing, docs - user uploaded documents

## Other responses

- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/d7195c30b6b1/schema)