---
title: "Retrieve an employment"
method: GET
path: "/v1/links/{link_id}/employment/"
tags: ["Employment"]
---

# Retrieve an employment

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

Get the most recent employment data

## Response `200`

- EmploymentLinked — Employment data
  - `income` string, decimal, nullable — Income amount not including commission or bonuses
  - `income_unit` 'YEARLY' | 'MONTHLY' | 'WEEKLY' | 'DAILY' | 'HOURLY' | 'null', nullable — The pay interval the income field refers to: * `YEARLY` - Annual income, * `MONTHLY` - Monthly income, * `WEEKLY` - Weekly income, * `DAILY` - Daily income, * `HOURLY` - Hourly income
  - `pay_rate` string, decimal, nullable — Payment rate per pay cycle
  - `pay_frequency` 'M' | 'SM' | 'W' | 'BW' | 'A' | 'SA' | 'C' | 'null', nullable — Pay frequency: * `M` - Monthly, * `SM` - Semi-Monthly, * `W` - Weekly, * `BW` - Bi-Weekly, * `A` - Annually, * `SA` - Semiannually, * `C` - Commission
  - `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, required — 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
  - `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
  - `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.

## 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/b92671dcb52d/schema)