Discussions

We use Personio as the source of truth for contractual working hours and absences. To calculate expected working hours accurately, we also need the public holidays that apply to each employee, including regional, local and company-specific calendar entries.

Currently, GET /v2/workplaces exposes workplace IDs and names, but no holiday calendar details. The v1 employee response includes holiday calendar metadata (id, name, country, state), but not the actual holiday dates. We have not found a documented endpoint for retrieving those dates.

Could you confirm whether this is supported elsewhere? If not, we would like to request read-only API access to:

• Holiday calendars with stable IDs.
• The holiday dates within a specified date range, including their names and whether they represent a full or partial non-working day.
• The calendar assigned to each employee, including workplace defaults and individual overrides, where applicable.
• Effective dates for calendar assignment changes, so historical calculations remain accurate.

For example, endpoints such as GET /v2/holiday-calendars and GET /v2/holiday-calendars/{id}/holidays?from=…&to=…, together with an employee-to-calendar reference, would address this need. Alternatively, extending the workplace schema could help, provided employee-specific assignments are also covered.

Why this matters: A country code alone is insufficient, particularly in countries such as Spain where regional and local holidays differ. Maintaining a separate holiday database can also produce results that disagree with the calendars configured in Personio.

Absence-period breakdowns do not fully solve this: they account for holidays within existing absences, but cannot provide a complete calendar for days without an absence.

We only need calendar data and assignments—not additional absence reasons or write permissions.