Get vacation statistics

Returns comprehensive vacation statistics for the current employee for a specific year.

What is returned:

• Vacation entitlement by contract
• Days periods (when vacation days were added/deducted)
• Pending vacation days (requests awaiting approval)
• Approved future vacation days
• Approved past vacation days (already taken)
• Vacation days from overtime conversion
• Added/deducted days (manual adjustments)
• Total vacation days available
• Total used vacation days
• Total remaining vacation days
• Potential vacation days (including pending requests)

Note: This endpoint is only available for employee accounts. If no year is provided in the query parameter, the current year is used.

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

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

import requests

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

{
  "added": 0,
  "approvedFutureVacationDays": 10,
  "approvedPastVacationDays": 8,
  "byContract": 25,
  "daysPeriods": [
    {
      "days": 25,
      "from": "2024-01-01T00:00:00.000Z",
      "to": "2024-12-31T23:59:59.999Z"
    }
  ],
  "deducted": 0,
  "fromOvertime": 2,
  "pendingVacationDays": 5,
  "potentialVacationDays": 3,
  "totalRemainingVacationDays": 19,
  "totalUsedVacationDays": 8,
  "totalVacationDays": 27,
  "year": 2024
}