Placement

Pre check for a placement creation

Changed on Sep 29, 2026

Performs a pre-check to determine whether a placement can be created with the provided data. Note: a successful pre-check does not guarantee that the placement can still be created later. For example, the minimum CLA wage may have changed between the pre-check and the actual creation of the placement.

post/public/placement/v1/pre-check-create-placement

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
TypeScript
https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/placement/v1/pre-check-create-placement/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

workerIdstring uuid required

The unique id of the worker, as returned from the /create-worker endpoint.

companyIdstring uuid required

The unique id of the client company.

departmentIdstring uuid

Optional. The unique id of the client company's department at which the worker will work. If not provided, the first department of the client company is used.

locationIdstring uuid required

The unique id of the client company's location at which the worker will work.

contactIdstring uuid required

The unique id of the client company's contact person (who will be mentioned in the contract).

startDatestring date required

The start date of the placement's contract, in ISO 8601 calendar date (YYYY-MM-DD).

endDatestring date required

The end date of the placement's contract, in ISO 8601 calendar date (YYYY-MM-DD).

shiftStartDateTimestring date-time required

The timestamp when the shift connected to the placement starts. Format: ISO 8601, must be in UTC. example: '2024-09-25T15:30:00Z'

shiftEndDateTimestring date-time required

The timestamp when the shift connected to the placement ends. Format: ISO 8601, must be in UTC. example: '2024-09-25T18:30:00Z'

collectiveLabourAgreementNumberinteger required

Number for this placement's collective labour agreement, as published by Centraal Bureau voor de Statistiek. Must be one of the collective labour agreements that are already registered for the given companyId

functionIdstring uuid required

The function applicable to the worker's activities for this placement. The id must be a value returned from the collective-labour-agreement API. Must be compatible with the collectiveLabourAgreementNumber.

functionTypestring

The function type applicable to the worker's activities for this placement. Must be a value returned from the collective-labour-agreement API. Must be compatible with the functionId.

functionLevelstring required

The function level applicable to the worker's activities for this placement. Must be a value returned from the collective-labour-agreement API. Must be compatible with the functionId.

educationstring

The education level applicable to the worker's activities for this placement. Must be a value returned from the collective-labour-agreement API. Must be compatible with the collectiveLabourAgreementNumber, functionType, functionLevel, and worker's age.

wageStepstring

The wage step applicable to the worker for this placement. Must be a value returned from the collective-labour-agreement API. Must be compatible with the collectiveLabourAgreementNumber, functionType, functionLevel, worker's age, education, and placement start date.

baseHourlyWagenumber required

The hourly wage the worker will earn for this placement, excluding surcharges, holiday allowance, etc. Must be compatible with the collective labour agreement-related properties, such as functionLevel, education, and wageStep.

hoursPerWeeknumber required

The number of hours the worker will work per week for this placement. The maximum comes from https://www.rijksoverheid.nl/onderwerpen/werktijden/vraag-en-antwoord/wettelijke-regels-werktijden-en-rusttijden

Example request

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-28",
  "baseHourlyWage": 18.21
}

Response

Successful pre-check with a possible error.

Example response

{
  "error": {
    "message": "Base hourly wage (10.15) is below the minimum (13.25, based on the CLA)"
  }
}

Changes

Sep 29, 2026f9510f3f4b22 Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  the request's body type changed from no type to object
- breaking
  the response's body type changed from no type to object for status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the optional property to the response with the status
Sep 29, 20263352b56bb8fe Revision changes
- breaking
  the request's body type changed from object to no type
- breaking
  the response's body type changed from object to no type for status
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the optional property from the response with the status

Operation history (8 revisions)