v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Benefits

Get year-to-date benefit amounts from a different company

Retrieves year-to-date benefit amounts that were contributed at a different company for the specified employee. Returns benefit amounts for the requested tax year (defaults to current year if not specified).

This endpoint only supports retrieving outside contributions for 401(k) benefits.

scope: employee_benefits:read

get/v1/employees/{employee_id}/ytd_benefit_amounts_from_different_company

Path parameters

employee_idstring required

The UUID of the employee

Query parameters

tax_yearinteger

Example:2024

The tax year for which to retrieve YTD benefit amounts. Defaults to current year if not specified.

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

uuidstring required

The unique identifier for this benefit amount record.

benefit_typeinteger required

The benefit type supported by Gusto. See Benefit Types for more information.

ytd_employee_deduction_amountstring required

The year-to-date employee deduction made outside the current company.

ytd_company_contribution_amountstring required

The year-to-date company contribution made outside the current company.