Get pending vacation requests
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 identifierdateFrom: 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 vacationcapacity: 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
teamIdquery 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
GET
/vacations/pendingAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredQuery parameters
teamIdstringOptional team ID (UUID) to filter vacation requests for a specific team. If not provided, returns requests based on the manager permissions (all teams for manageAll, or manager teams for manageTeams). This parameter is useful for team-specific managers who want to focus on a particular team.
Responses
200Successfully retrieved pending vacations
Array of
objectobject401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X GET "https://leadtime.app/api/public/vacations/pending" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/vacations/pending", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.get(
"https://leadtime.app/api/public/vacations/pending",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
[
{}
]Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions