---
search:
  tags:
    - vacations
    - GET
seo:
  description: >-
    Retrieves all pending vacation requests that are awaiting manager approval.
    Reference for the GET /vacations/pending endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get pending vacation requests
title: Get pending vacation requests
type: openapi-operation
---
Retrieves all pending vacation requests that are awaiting manager approval.

**What is Vacation Management?**
Vacation management digitizes the entire vacation process and ensures transparent, traceable, and efficient vacation planning. Employees can submit vacation requests, and managers can review and approve them while considering business workload and capacity.

**What is returned:**
Each vacation request includes:
- `id`: Unique vacation request 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 of the request (always "Pending" for this endpoint)
- `userId`: ID of the employee who requested the vacation
- `capacity`: Optional capacity utilization percentage for the vacation period

**How it works:**
- Only vacation requests with status "Pending" are returned
- Managers with "manageAll" permission see all pending requests across the workspace
- Managers with "manageTeams" permission only see requests from employees in their teams
- Use the optional `teamId` query parameter to filter requests for a specific team
- Results are sorted by start date (earliest first)

**Use cases:**
- Displaying a list of vacation requests that need approval
- Building a vacation approval dashboard
- Filtering requests by team for team-specific managers

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