--- search: tags: - vacations - GET seo: description: >- Retrieves vacation history with support for filtering, sorting, and… Reference for the GET /vacations/history endpoint in the Leadtime Public API API. sidebar: badge: GET label: Get vacation history grid title: Get vacation history grid type: openapi-operation --- Retrieves vacation history with support for filtering, sorting, and pagination. **What is returned:** A paginated grid response containing vacation history items. Each item includes: - `id`: Unique vacation identifier - `dateFrom`: Start date of the vacation period - `dateTo`: End date of the vacation period - `status`: Vacation status ("Rejected", "Cancelled", or past "Approved" vacations) - `employeeId`: ID of the employee who requested the vacation - `statusChangedAt`: Timestamp when the status was last changed - `statusChangedBy`: ID of the user who changed the status (null if not changed by a user) - `reason`: Optional reason provided when the vacation was declined or cancelled **What is included in history:** - All rejected vacation requests - All cancelled vacations (previously approved but then cancelled) - All approved vacations that have ended (dateTo < today) - Does not include pending or upcoming approved vacations (use the pending/upcoming endpoints for those) **Grid features:** - **Filtering**: Filter by date range, employee, status, or any other field - **Sorting**: Sort by any column (default sorting can be specified) - **Pagination**: Standard grid pagination with page size control - Grid parameters are automatically parsed from query string using standard grid format **How it works:** - Managers with "manageAll" permission see all vacation history across the workspace - Managers with "manageTeams" permission only see history from employees in their teams - Use the optional `teamId` query parameter to filter history for a specific team - Supports standard grid server-side parameters (filters, sort, pagination) **Use cases:** - Building a vacation history table with search and filter capabilities - Analyzing vacation patterns and trends - Reviewing past vacation decisions and reasons - Generating reports on vacation usage