Added

Holidays API

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.gte and date.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 cursor alone to get the next page.
  • Requires the personio:absences:read scope.

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.