---
title: "Get Talent Benefit YTD Summaries"
method: POST
path: "/v1/talent-benefit/ytd/{yearId}"
tags: ["TalentBenefits"]
---

# Get Talent Benefit YTD Summaries

`POST /v1/talent-benefit/ytd/{yearId}`

## Request

- Base URL: `https://api.avionte.com/back-office`
- URL: `https://api.avionte.com/back-office/v1/talent-benefit/ytd/{yearId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns year-to-date benefit summaries for the specified talents for a given year. Includes gross wages, hours worked, payroll deductions, and employer contributions. Accepts up to 100 talent GUIDs per request.

## Path parameters

- `yearId` string, required

## Headers

- `FrontOfficeTenantId` integer, required
- `RequestId` string, uuid, required

## Request body

- string[]

## Response `200`

200 response

- TalentBenefitYtdSummary[]
  - `talentGuid` string, guid: The unique identifier for the talent, formatted as a GUID.
  - `supplierGuid` string, guid: The unique identifier for the staffing company (supplier), formatted as a GUID. This is used to identify the supplier associated with the talent's benefit.
  - `grossWagesYtd` number, double: The total gross wages earned year-to-date by the talent.
  - `hoursYtd` number, double: The total hours worked year-to-date by the talent.
  - `payrollDeductions` TalentBenefitYtdDeductionSummary[]: The list of payroll deductions for the talent, including the deduction type and year-to-date amount.
    - `employeeDeductionGuid` string, guid: A unique identifier for the talent benefit deduction, formatted as a GUID.
    - `transactionTypeId` integer: The unique identifier for the transaction type.
    - `transactionTypeName` string: The display name of the transaction type.
    - `deductionAmountYtd` number: The year-to-date total deduction amount for the talent and the supplier.
  - `payrollContributions` TalentBenefitYtdContributionSummary[]: The list of payroll contributions for the talent, including the contribution type and year-to-date amount.
    - `employeeContributionGuid` string, guid: A unique identifier for the talent benefit contribution, formatted as a GUID.
    - `transactionTypeId` integer: The unique identifier for the transaction type.
    - `transactionTypeName` string: The display name of the transaction type.
    - `contributionAmountYtd` number: The year-to-date total contribution amount for the talent and the supplier.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `406`: Unsupported format(s) indicated by Accept header
- `415`: Unsupported format(s) indicated by the Content-Type header
- `429`: Too many requests
- `500`: An unexpected error occurred
- `502`: Service Unavailable

---

[API](https://skmtc.dev/avionte/apis/aviont-back-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/aviont-back-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/aviont-back-office-api/revisions/175a738cecd0?raw)