v1

latestOpenAPI 3.0.32026-08-0645108163.2 KB
Collective labour agreements

Determines the hourly wage for a function

Determines the minimum hourly wage for a function. This depends on the chosen fields through the other endpoints in this API. If a field has not been chosen, the highest applicable option will be chosen automatically.

get/public/collective-labour-agreement/v1/determine-minimum-hourly-wage

Query parameters

collectiveLabourAgreementNumberinteger required

The unique number of the collective labour agreement, as returned from the /get-collective-labour-agreements endpoint.

functionLevelstring required

The functionLevel, as returned from the /get-functions endpoint.

functionTypestring

The function type, as returned from the /get-functions endpoint.

functionSubtypestring

The functionSubtype

ageinteger
educationstring

The education, the name as returned from the /get-educations endpoint.

wageStepstring

The wageStep, as returned from the /get-wage-steps endpoint.

forceHighAwfboolean

Forces using high AWf premium. If omitted or set to false, the system determines the applicable AWf premium automatically.

effectiveDatestring date

The effective date for which the wage applies, in YYYY-MM-DD format. Defaults to today's date if not provided. Is adjusted forward to today, if a date in the past is provided. This ensures that an active wage set is used (older wages sets are expired, and are then no longer used).

For example, say that today is 2026-01-02, say there was a wage increase on 2026-01-01, and say you call this endpoint with an effectiveDate of 2025-12-31. This endpoint will then implicitly act as if you called it with an effectiveDate of 2026-01-02. That is, it will use the wage set of 2026-01-01.

This means that if you called it on 2025-12-31 and then call it again on 2026-01-01, it will return a different result for the same input parameters, because the effective date is silently increased to 2026-01-01.

This adjustment is done implicitly for backwards compatibility reasons. Future HTTP APIs may instead of return an HTTP 400 with an error code instead.

companyIdstring uuid

The unique id of the client company.

Response

Success

minimumBaseHourlyWagenumber required

The minimum wage per hour, in €.

minimumHourlyWageIncludingReservationsnumber required

The minimum wage per hour, including reservations for holiday payment, leave days and public holidays in €.

costPricenumber required

The cost price (factor) per hour, including reservations, insurances and premiums in € (excluding provision)

Example response

{
  "minimumBaseHourlyWage": 18.2,
  "minimumHourlyWageIncludingReservations": 18.21,
  "costPrice": 24.258
}