---
title: "Get Talent Benefit Enrollments"
method: GET
path: "/v1/talent-benefit/{talentGuid}"
tags: ["TalentBenefits", "Talent"]
---

# Get Talent Benefit Enrollments

`GET /v1/talent-benefit/{talentGuid}`

## Request

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

Returns benefit enrollment details for the specified talent as requested by the authorized partner. This includes a list of talent deductions and employer contributions.

## Path parameters

- `talentGuid` string, required

## Headers

- `FrontOfficeTenantId` integer, required
- `RequestId` string, uuid, required
- `supplierGuid` string: The unique identifier for the supplier (employer) record, formatted as a GUID.

## Response `200`

200 response

- TalentBenefit[]
  - `talentGuid` string, guid, required: 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.
  - `transactionTypeId` integer: The unique identifier for the talent benefit transaction type.
  - `benefitPayrollDeduction` TalentBenefitDeduction
    - `talentBenefitDeductionGuid` string, guid: A unique identifier for the talent benefit deduction, formatted as a GUID.
    - `deductionAmount` number, double, required: The amount to be deducted.
    - `deductionAmountType` 'Fixed' | 'PercentOfGross' | 'PercentOfNet'
    - `deductionStartDate` string, date-time, required: The start date for the deduction. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00.
    - `deductionEndDate` string, date-time: The end date for the deduction. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00.
    - `deductionPayCycle` 'Unknown' | 'Weekly' | 'BiWeekly' | 'Monthly' | 'SemiMonthly' | 'Daily' | 'Yearly' | 'Hourly', required
    - `referenceNumber` string: A reference number associated with the deduction.
    - `payPeriodLimit` number: The maximum deduction amount allowed per pay period. If no limit, then set to 0.
    - `monthlyLimit` number: The maximum deduction amount allowed per month. If no limit, then set to 0.
    - `yearlyLimit` number: The maximum deduction amount allowed per year. If no limit, then set to 0.
    - `lifeTimeLimit` number: The maximum deduction amount allowed over the lifetime of the deduction. If no limit, then set to 0.
    - `note` string: An optional note or comment related to the deduction.
    - `isActive` boolean: An indication of whether the deduction is active or not.
    - `isCourtOrdered` boolean: An indication of whether the deduction is the result of a court order.
  - `benefitPayrollContribution` TalentBenefitContribution
    - `talentBenefitContributionGuid` string, guid: A unique identifier for the talent benefit contribution, formatted as a GUID.
    - `contributionAmount` number, double, required: The amount the employer will contribute to the talent.
    - `contributionAmountType` 'Fixed' | 'PercentOfGross' | 'PercentOfNet'
    - `contributionStartDate` string, date-time, required: The start date for the contribution. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00.
    - `contributionEndDate` string, date-time: The end date for the contribution. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00.
    - `contributionPayCycle` 'Unknown' | 'Weekly' | 'BiWeekly' | 'Monthly' | 'SemiMonthly' | 'Daily' | 'Yearly' | 'Hourly', required
    - `referenceNumber` string: A reference number associated with the benefit contribution.
    - `payPeriodLimit` number: The maximum contribution amount allowed per pay period. If no limit, then set to 0.
    - `monthlyLimit` number: The maximum contribution amount allowed per month. If no limit, then set to 0.
    - `yearlyLimit` number: The maximum contribution amount allowed per year. If no limit, then set to 0.
    - `lifeTimeLimit` number: The maximum contribution amount allowed over the lifetime of the contribution. If no limit, then set to 0.
    - `note` string: An optional note or comment related to the contribution.
    - `isActive` boolean: An indication of whether the contribution is active or not.

## 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)