Nederlandse feestdagen API met CAO toeslag berekening per branche. Controleer elke datum en ontvang de juiste toeslagfactor voor horeca, retail, transport en meer.

GET /v1/hr/holiday-surcharge

Returns whether a specific date is a Dutch public holiday and the applicable CAO (collective labour agreement) surcharge multiplier for your industry.

Use this endpoint to:

Calculate holiday pay for any Dutch public holiday
Audit payroll systems for correct public holiday handling
Build HR tools that automatically flag holiday-rate days

Request parameters

Parameter	Type	Required	Default	Description
`date`	string	✓	—	Date in `YYYY-MM-DD` format
`industry`	string	✗	`algemeen`	CAO sector (see table below)

Supported industries

Value	Sector
`horeca`	Hotels, restaurants & catering
`retail`	Retail trade
`transport`	Road transport & logistics
`zorg`	Healthcare & welfare
`bouw`	Construction
`schoonmaak`	Cleaning services
`algemeen`	General / catch-all

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.omnizoek.nl/v1/hr/holiday-surcharge?date=2026-04-05&industry=horeca"

Example response — holiday

{
  "date": "2026-04-05",
  "is_holiday": true,
  "holiday_name": "Eerste Paasdag",
  "industry": "horeca",
  "surcharge_multiplier": 2.0,
  "surcharge_basis": "CAO Horeca 2024-2026 art. 21",
  "disclaimer": "Always verify against the applicable CAO version."
}

Example response — not a holiday

{
  "date": "2026-06-01",
  "is_holiday": false,
  "holiday_name": null,
  "industry": "retail",
  "surcharge_multiplier": 1.0,
  "surcharge_basis": null,
  "disclaimer": "Always verify against the applicable CAO version."
}

Response fields

Field	Type	Description
`date`	string	Date as provided (ISO 8601)
`is_holiday`	boolean	`true` if date is a Dutch public holiday
`holiday_name`	string \| null	Dutch name of the holiday, or `null`
`industry`	string	Industry as provided (or `algemeen`)
`surcharge_multiplier`	number	Pay multiplier: `1.0` on normal days, `2.0` on holidays typical for many sectors
`surcharge_basis`	string \| null	CAO article reference, or `null` on normal days
`disclaimer`	string	Fixed legal disclaimer — always verify with the current CAO text

Dutch public holidays covered

Holiday	Date rule
Nieuwjaarsdag	1 January
Eerste Paasdag	Easter Sunday (computed)
Tweede Paasdag	Easter Monday (computed)
Koningsdag	27 April (26 Apr if Sunday)
Bevrijdingsdag	5 May (lustrum years only for mandatory day off)
Hemelvaartsdag	Ascension Day (Easter + 39 days)
Eerste Pinksterdag	Whit Sunday (Easter + 49 days)
Tweede Pinksterdag	Whit Monday (Easter + 50 days)
Eerste Kerstdag	25 December
Tweede Kerstdag	26 December

Easter Sunday is computed via the anonymous Gregorian algorithm.

Error responses

Status	Cause
`422`	Malformed `date` string
`422`	`industry` is not one of the supported values

Caching

This endpoint does not cache — computation is pure arithmetic (~microseconds).

Feestdagtoeslag (CAO)