Minimum Wage (WML)
Minimum wage API for the Netherlands — WML calculator based on the Wet minimumloon. Get the statutory minimum wage by age and date, per hour, day and month.
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.
BSN & IBAN Validator
BSN validation API and IBAN check API for the Netherlands — mathematical validation via elfproef and MOD-97. No external calls, blazing fast.
Holiday Surcharge (CAO)
Dutch public holidays API with CAO surcharge calculation per sector. Check any date and receive the correct surcharge factor for hospitality, retail, transport and more.