---
title: "Get Talent Tax History"
method: GET
path: "/v3/talent/tax-history"
tags: ["Taxes"]
---

# Get Talent Tax History

`GET /v3/talent/tax-history`

Returns tax history for the specified talent.

## Query parameters

- `talentGuid` string, uuid
- `talentExternalId` string

## Headers

- `FrontOfficeTenantId` integer, required
- `RequestOrigin` string, required
- `RequestId` string, uuid, required — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `ExternalIdSource` 'BOLD', required
- `RequestUserExternalId` string

## Response `200`

Successfully retrieved talent tax history.

- TaxHistory[]
  - `employeeGuid` string, uuid — The unique identifier for the Talent record, formatted as a UUID.
  - `officeDivision` string — The name of the division associated with the tax history data.
  - `office` string — The name of the office associated with the tax history data.
  - `officeId` integer, nullable — The identifier for the Office associated with the tax history data.
  - `year` integer — The check date’s year for the tax history data.
  - `taxName` string — The name of the tax.
  - `taxCategory` 'Employee Portion' | 'Employer Portion'
  - `subjectGross` number — The total amount of subject gross for this tax, grouped by talent, supplier, and year.
  - `taxableGross` number, nullable — The total amount of taxable gross for this tax, grouped by talent, supplier, and year.
  - `taxAmount` number, nullable — The total amount of tax withheld for this tax, grouped by talent, supplier, and year.

## Other responses

- `402` — Additional subscription required.
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/revisions/846b33e4e71b/schema)