v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Time Off
Public API

List Employee Time Off Policies (v1.1)

Returns the time off policies currently assigned to a specific employee, as a list of {timeOffPolicyId, timeOffTypeId, accrualStartDate} records. Use this to find which policy governs each time off type for this employee and when their accruals began. This is the per-employee assignment view; use list-time-off-policies for the company-wide policy catalog. Includes all policy types (accruing, manual, and unlimited); the v1 form of this endpoint excluded manual and unlimited types — v1.1 includes them.

OAuth Scopes: time_off

get/api/v1_1/employees/{employeeId}/time_off/policies

Path parameters

employeeIdstring required

The internal employee ID.

Response

The list of time off policies assigned to the employee, including manual and unlimited types.

timeOffPolicyIdstring

The ID of the assigned time off policy.

timeOffTypeIdinteger

The ID of the time off type.

accrualStartDatestring date nullable

The date accruals started in YYYY-MM-DD format. Null for manual and unlimited policy types.