v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Employees

Get employee time off activities

Get employee time off activities.

scope: employee_time_off_activities:read

get/v1/employees/{employee_uuid}/time_off_activities

Path parameters

employee_uuidstring required

The UUID of the employee

Query parameters

time_off_typestring required

The time off type name you want to query data for. ex: 'sick' or 'vacation'

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

Success

policy_uuidstring nullable

unique identifier of a time off policy

time_off_type'vacation' | 'sick'

Type of the time off activity

policy_namestring nullable

The name of the time off policy for this activity

event_typestring

The type of the time off event/activity

event_descriptionstring nullable

A description for the time off event/activity

effective_timestring nullable

The datetime of the time off activity

balancestring float nullable

The time off balance at the time of the activity

balance_changestring float nullable

The amount the time off balance changed as a result of the activity