Skip to content
Voxbi Cockpit APIs
API Guides

Public holidays

A public holiday in Tempus is a statutory non-working day declared by a country or region, such as New Year's Day or Christmas. Each entry is one date attached to one country.

Overview

Public holidays are the legal background: dates everyone in the country gets off regardless of contract or company. They differ from holiday calendars (company-specific extra off-days) and absences (per-employee leave). Most tenants populate the table once a year using the Fetch button.

What it does

A public holiday is keyed by country and date, so Christmas 2026 in Luxembourg and in France are separate rows, as are Christmas 2026 and 2027. Employees are matched by their contract's location country.

On a matching public holiday:

  • Expected hours drop to zero for that day.
  • The day is marked on the calendar view.
  • Overtime worked is valued at the configured pay percentage (100% standard, 150% time-and-a-half, 200% double).
  • The leave balance is credited only if the company's Add public holidays to balance setting is on.

The Fetch action calls an external service and inserts every officially declared holiday for a country and year (or a range of years) in one call. Entries for the same date and country are upserted, not duplicated.

See also

Updated