MAmaqqie
Collective labour agreements

Determines the hourly wage for a function

Changed on

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

Request

  • Base URL
    https://api.maqqie.app (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Client credentials
    Token URLhttps://maqqie.app/auth/realms/maqqie/protocol/openid-connect/token

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
}

Changes

  • f9510f3f4b22Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to string for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 3352b56bb8feRevision changes
    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from string to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      response schema application/json enum value removed FUNCTION_TYPE_REQUIRED_FOR_CLA

    • info

      response schema application/json enum value removed INVALID_COMBINATION_FOR_CLA

    • info

      response schema application/json enum value removed UNSUPPORTED_CLA_NUMBER