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, for example by calling this endpoint for their own record as a control.

OAuth Scopes: time_off