Get upcoming approved vacations

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

curl -X GET "https://leadtime.app/api/public/vacations/upcoming" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/vacations/upcoming", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/vacations/upcoming",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

[
  {}
]