Zum Inhalt springen
Leadtime
Deutsch
Esc
↑↓navigieren↵öffnen⌘Jvorschau

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
200

Successfully retrieved pending vacations

Array of object
object
401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Parameters
Request
curl -X GET "https://leadtime.app/api/public/vacations/pending" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {}
]