--- title: "List of wage proposals for the employments of an employer" method: GET path: "/v2/providers/employers/{employerId}/employees/employments/WageProposals" tags: ["Wage proposal"] --- # List of wage proposals for the employments of an employer `GET /v2/providers/employers/{employerId}/employees/employments/WageProposals` ## Request - Base URL: `https://api.loket.nl` - URL: `https://api.loket.nl/v2/providers/employers/{employerId}/employees/employments/WageProposals` - Auth: none required __Activity name :__ GetWageProposalsByEmployerId Returns a list of wage proposals for the employments of the employer. A wage proposal is created when an employment reaches the criteria set for the next tier of wage. E.G the minimum wage is linked to the age of a person so a wage proposal is created 60 days befor the birthday of an employment linked to the minimum wage and configured for wage proposals. Via this functionality the created wage proposal can be approved or rejected resulting in either a new wage record updated to reflect the correct wage or in case of a rejection the employment is disabled for wage proposals. ## Path parameters - `employerId` string, uuid, required ## Query parameters - `filter` string - `orderBy` string - `pageNumber` integer - `pageSize` integer ## Headers - `Authorization` string, required - `Accept` string, required ## Response `200` OK - object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour. - `totalSize` integer: Total number of records, taking into account the given filter. - `pageSize` integer: Number of records in the response - `totalPages` integer: Number of pages available - `currentPage` integer: Current page returned in the response - `version` Version - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available - `resourceVersion` string, date: The resource version of the object in the response - `messages` object[] - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages) - `description` string: Describes the message - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity - `code` integer: Identifying code for the message - `properties` string[]: An array that can contain additional information - `_embedded` WageProposalObject[] - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `payScale` PayScale, nullable: A pay scale (also known as a salary structure) is a system that determines how much an employee is to be paid as a wage or salary, based on one or more factors such as the employee"s level, rank or status within the employer"s organization, the length of time that the employee has been employed, and the difficulty of the specific work performed. After selecting a pay scale a pay grade needs to be selected to determine the actual wage. Only works with `grossWage`. The value of `grossWage` will be updated server side after the submit. `payScale` is a metadata field within the payroll administration/payScale context. Possible values can be managed by the user. - `key` integer - `value` string - `grossWageType` GrossWageType, nullable: Indicates whether the `grossWage` is an hourly wage or a periodic wage. Periodic can represent a week, four weeks or a month. Which period is active for the employment can be found in wagePeriodType. - `key` integer - `value` string - `currentPayGrade` PayGrade2, nullable: The pay grade indicates on what level (cel) of the paygrade the employment is. The level is multi dimensional where the description indicates both the level and for example the number of years of service within the given level. `payGrade` is a metadata field within the payroll administration/payScale context. Possible values can be managed by the user. - `key` integer - `value` string - `currentGrossWage` number, double, nullable: The gross wage for the employee - `proposedPayGrade` PayGrade2, nullable: The pay grade indicates on what level (cel) of the paygrade the employment is. The level is multi dimensional where the description indicates both the level and for example the number of years of service within the given level. `payGrade` is a metadata field within the payroll administration/payScale context. Possible values can be managed by the user. - `key` integer - `value` string - `proposedGrossWage` number, double, nullable: The gross wage for the employee - `startDateProposal` string, date: The date to which the declaration is applicable. As requested by the employee. - `proposalReason` object, nullable - `key` integer: The key of the reason - `value` string: The description of the reasson for the proposal - `status` object: The current status of the wage proposal The status is changed by using the PATCH endpoint. 1. Voorgesteld --> Accept or reject 2. Goedgekeurd ---> No changes possible 3. Afgekeurd ---> No changes possible 5. Niet verwerkbaar ---> No changes possible - `key` integer - `value` string - `employmentInformation` object - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `employeeNumber` integer: The employee number to uniquely identify an employee within an employer - `firstName` string, nullable: The first name, given name, forename or Christian name as part of a persons personal name. - `formattedName` string: Formatted name of the employee based on the value of `howToFormatLastName` - `incomeRelationshipNumber` integer: The income relationship number that is required in the tax return. Together with the citizen service number (burgerservicenummer, BSN) and wage tax number, the income relationship number uniquely identifies an employment. - `photo` string, url, nullable: A photo of the employee to use as a avatar/profile picture. The last part of the returned endpoint is the version of the logo this allows users to cache the image. Changing the value of the version will not influence the output. - `payrollAdministration` object, nullable: Id of the payroll administration. This field cannot simultaneously have a value with nonPayrollAdministration (only one can have a value at a time) `payrollAdministration` is a metadata field within the employer context. Possible values can be managed by the user. - `id` string, uuid: The unique identifier of an object (GUID/UUID) - `name` string: Name of the payroll administration - `clientNumber` integer: The client number is a unique number for administrations that are used for payrolling. This field has no value if the administration is not used for payrolling. - `description` string: Description of the administration - `function` object: The function of the employment. `function` is a metadata field within the employer context. Possible values can be managed by the user. - `key` string, uuid: The unique identifier of an object (GUID/UUID) - `description` string - `group` string, nullable - `department` object: The department of the employment. `department` is a metadata field within the employer context. Possible values can be managed by the user. - `key` string, uuid: The unique identifier of an object (GUID/UUID) - `code` integer - `description` string ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `500`: Internal Server Error --- [API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)