Minimumloon API voor Nederland — WML calculator API conform de Wet minimumloon. Haal het wettelijk minimumloon op per leeftijd en datum, per uur, dag en maand.

GET /v1/hr/minimum-wage

Returns the Dutch statutory minimum hourly, daily, and monthly wage for a given age and reference date, based on the official Wet minimumloon (WML) tables.

Rates are updated in advance for each half-year period (1 Jan and 1 Jul). The API currently covers 2024 H1 – 2026 H1.

Request parameters

Parameter	Type	Required	Default	Description
`age`	integer	✓	—	Worker age in years (15 – 99)
`date`	string	✗	today	Reference date in `YYYY-MM-DD` format

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.omnizoek.nl/v1/hr/minimum-wage?age=23&date=2026-01-01"

Example response

{
  "age": 23,
  "date": "2026-01-01",
  "hourly_eur": 14.06,
  "daily_eur": 112.45,
  "monthly_eur": 2069.40,
  "law_reference": "WML 2026-H1",
  "note": "Adult rate"
}

Example response — youth wage

{
  "age": 17,
  "date": "2026-01-01",
  "hourly_eur": 7.74,
  "daily_eur": 61.85,
  "monthly_eur": 1138.17,
  "law_reference": "WML 2026-H1",
  "note": "Youth rate 55% of adult minimum wage"
}

Response fields

Field	Type	Description
`age`	integer	Age as provided
`date`	string	Effective date (ISO 8601)
`hourly_eur`	number	Gross minimum hourly wage in EUR
`daily_eur`	number	Gross minimum daily wage (× 8 h) in EUR
`monthly_eur`	number	Gross minimum monthly wage in EUR
`law_reference`	string	WML period identifier (e.g. `WML 2026-H1`)
`note`	string	`"Adult rate"` or `"Youth rate X% of adult minimum wage"`

Youth wage percentages (all periods)

Age	% of adult wage
15	40%
16	45%
17	50%
18	60%
19	70%
20	80%
21+	100% (adult rate)

Error responses

Status	Cause
`400`	`age` outside range 15 – 99
`400`	`date` not in a covered WML period
`422`	Malformed `date` string

Caching

This endpoint does not cache — computation is pure arithmetic (~microseconds). The tables embedded in the API are updated when a new WML period is enacted.

Minimumloon (WML)