Discussions
Access to Vacation Entitlement via API
Hi Personio team,
I'm currently working on an ETL process to extract employee absence data from Personio and save it in our internal SQL database. One key requirement is to also retrieve each employee’s vacation entitlement (i.e., the total yearly allowance), but I’m running into some limitations.
Here's what I've discovered so far:
In API v1, I can get the absence balance, but not the vacation entitelment. https://developer.personio.de/v1.0/reference/get_company-employees-employee-id-absences-balance
In API v2, there doesn't seem to be any endpoint that exposes either the entitlement or the balance.
Our HR team did create a Custom Report that contains this information, but they’re hesitant to enable API access because, as I understand, it's currently not possible to restrict the API token to access only a single report (and not all reports).
What I’m trying to achieve:
I need a reliable and secure way to access each employee’s vacation entitlement through the Personio API for reporting and automation purposes.
My questions:
Is there any official way (or workaround) to access vacation entitlements via v1 or v2?
Is it true that the API can access all Custom Reports once enabled — and that it's not possible to restrict access to just one?
Are there any upcoming changes in the API or best practices that would help solve this?
Thanks in advance for your help and guidance!
Best regards,