Returns time off requests within the specified date range. Both start and end query parameters are required (YYYY-MM-DD). The search is inclusive: requests whose date range overlaps the query window are returned. Results can be filtered by status, employee, time off type, or limited to requests the caller can approve.

Do not pass employeeId=0 expecting the caller's own requests. Unlike Get Employee (get-employee), the 0 self sentinel is not supported here and returns an empty array with HTTP 200 rather than an error, which is easily misread as the caller having no requests. Use action=myRequests for the authenticated caller's own requests, or resolve their internal employee ID with get-employee using the id 0 and pass that value.

An empty result does not mean the employee has no requests. A caller who lacks permission to view another employee's time off receives an empty array with HTTP 200, indistinguishable from an employee with no requests in the window. Before concluding that someone has no time off requests, confirm that the window is wide enough and that the caller can actually view that employee. This endpoint and Get Time Off Balance (get-time-off-balance) are gated independently, so neither one's outcome predicts the other's. A caller can receive 403 from the balance endpoint for an employee while still receiving that same employee's requests here, which has been observed for a manager viewing a direct report. Do not infer access to one endpoint from access to the other, and do not treat a result from one as evidence about the other.

OAuth Scopes: time_off