Added
Holidays API
42 minutes ago by Public API Support
What's new
You can now read the holidays that apply to your employees through the v2 Public API, secured with OAuth 2.0:
GET /v2/holidays: list the holidays of persons within a date range
It returns one entry per person and date, from the holiday calendars assigned to each person through their office or the company. Each entry has the date and name of the holiday, whether it covers the full day or half of it, and whether it is a public holiday or one defined by the company.
How to use it
- Filter by
person.id(up to 50 persons per request),date.gteanddate.lte. All three are required on the first request. - The date range can start at most 10 years ago and end at most 3 years from today.
- Results are sorted by person, then by date, and paginated with a cursor. Pass
cursoralone to get the next page. - Requires the
personio:absences:readscope.
Why
Integrations that plan time, schedule shifts or calculate working days need to know which days are holidays for each employee. Until now that meant keeping holiday calendars up to date outside Personio. The Holidays API gives you the same holidays Personio uses for each employee.

