Zum Inhalt springen
Leadtime
Deutsch
Esc
navigateopen⌘Jpreview

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 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
GET/vacations/pending
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Query parameters
teamIdstring
Optional 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 object
object
401Unauthorized - 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"
Response
[
  {}
]