---
search:
  tags:
    - vacations
    - GET
seo:
  description: >-
    Retrieves all approved vacations that have not yet ended (end date is today…
    Reference for the GET /vacations/upcoming endpoint in the Leadtime Public
    API API.
sidebar:
  badge: GET
  label: Get upcoming approved vacations
title: Get upcoming approved vacations
type: openapi-operation
---
Retrieves all approved vacations that have not yet ended (end date is today or in the future).

**What is returned:**
Each vacation includes:
- `id`: Unique vacation identifier
- `dateFrom`: Start date of the vacation period (ISO 8601 date string)
- `dateTo`: End date of the vacation period (ISO 8601 date string)
- `status`: Current status (always "Approved" for this endpoint)
- `userId`: ID of the employee taking the vacation
- `capacity`: Optional capacity utilization percentage for the vacation period

**How it works:**
- Only vacations with status "Approved" and end date >= today are returned
- This includes both current vacations (in progress) and future approved vacations
- Managers with "manageAll" permission see all upcoming vacations across the workspace
- Managers with "manageTeams" permission only see vacations from employees in their teams
- Use the optional `teamId` query parameter to filter vacations for a specific team
- Results are sorted by start date (earliest first)

**Use cases:**
- Displaying an overview of upcoming time off for capacity planning
- Building a team calendar showing approved absences
- Identifying potential scheduling conflicts
- Showing managers which employees will be absent in the near future

<Operation source="api-reference" id="vacationscontroller-getupcomingvacations" />