---
title: "Changes to Retrieve an income and employment report for a link"
method: GET
path: "/v1/links/{link_id}/income/report/"
---

# Changes to Retrieve an income and employment report for a link

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 23 revisions.

- **2026-10-30** `64de38c55f45`: 2 info
- **2026-08-08** `6542a8962887`: 1 info
- **2026-07-27** `f7c013875516`: 1 warning, 37 info
- **2026-07-26** `e58688835e25`: 13 breaking, 3 warning

## Changes

- **2026-10-30** `64de38c55f45`: 2 info
  - added the new optional `query` request parameter `show_fraud_reasons`
  - added the optional property `fraud_reasons` to the response with the `200` status
- **2026-08-08** `6542a8962887`: 1 info
  - added the non-success response with the status `404`
- **2026-07-27** `f7c013875516`: 1 warning, 37 info
  - added the new `C` enum value to the `employments/items/statements/items/basis_of_pay` response property for the response status `200`
  - the `employments/items/annual_income_summary/items/bonus` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/commission` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/gross_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/net_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/other_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/overtime` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/annual_income_summary/items/regular` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/bank_accounts/items/deposit_value` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/income` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/pay_rate` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/profile/ssn` response's property pattern `^(\d{4}|\d{9})$` was added for the status `200`
  - the `employments/items/statements/items/bonus` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/bonus_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/commission` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/commission_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/deductions/items/amount` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/deductions_ytd/items/amount` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/earnings/items/amount` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/earnings_ytd/items/amount` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/gross_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/gross_pay_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/hours` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/net_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/net_pay_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/other_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/other_pay_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/overtime` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/overtime_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/regular` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/statements/items/regular_ytd` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/federal_tax` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/gross_pay` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/medicare_tax` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/medicare_wages` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/social_security_tax` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/social_security_wages` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `employments/items/w2s/items/wages` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
- **2026-07-26** `e58688835e25`: 13 breaking, 3 warning
  - the response property `employments/items/end_date` became nullable for the status `200`
  - the response property `employments/items/external_last_updated` became nullable for the status `200`
  - the response property `employments/items/income` became nullable for the status `200`
  - the response property `employments/items/income_unit` became nullable for the status `200`
  - the response property `employments/items/is_active` became nullable for the status `200`
  - the response property `employments/items/job_title` became nullable for the status `200`
  - the response property `employments/items/job_type` became nullable for the status `200`
  - the response property `employments/items/original_hire_date` became nullable for the status `200`
  - the response property `employments/items/pay_frequency` became nullable for the status `200`
  - the response property `employments/items/pay_rate` became nullable for the status `200`
  - the response property `employments/items/profile/full_name` became nullable for the status `200`
  - the response property `employments/items/profile/ssn` became nullable for the status `200`
  - the response property `employments/items/start_date` became nullable for the status `200`
  - added the new `undefined` enum value to the `employments/items/income_unit` response property for the response status `200`
  - added the new `undefined` enum value to the `employments/items/job_type` response property for the response status `200`
  - added the new `undefined` enum value to the `employments/items/pay_frequency` response property for the response status `200`

---

[Operation](https://skmtc.dev/truv/apis/truv-api/docs/v1/links/:link_id/income/report/get.md) - [API](https://skmtc.dev/truv/apis/truv-api.md) - [Page](https://skmtc.dev/truv/apis/truv-api/changes/v1/links/:link_id/income/report/get)
