v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Employments

Get employment history for an employee

Retrieve the employment history for a given employee, which includes termination and rehire.

scope: employments:read

get/v1/employees/{employee_id}/employment_history

employee_idstring required

The UUID of the employee

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.

successful

hire_datestring

The employee's start day of work for an employment.

termination_datestring nullable

The employee's last day of work for an employment.

file_new_hire_reportboolean

The boolean flag indicating whether Gusto will file a new hire report for the employee.

two_percent_shareholderboolean

Whether the employee is a two percent shareholder of the company. This field only applies to companies with an S-Corp entity type.

employment_status'part_time' | 'full_time' | 'part_time_eligible' | 'variable' | 'seasonal - not_set'

The employee's employment status. Supplying an invalid option will set the employment_status to not_set.