---
title: "Add a base for calculation"
method: POST
path: "/v2/providers/employers/employees/employments/{employmentId}/basesforcalculation"
tags: ["Base for calculation"]
---

# Add a base for calculation

`POST /v2/providers/employers/employees/employments/{employmentId}/basesforcalculation`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}/basesforcalculation`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/PostBaseForCalculationByEmploymentId" target="_blank">PostBaseForCalculationByEmploymentId</a>

__Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the POST URL.

__Defaults :__ Default values for a new object can be acquired by adding `/defaults` to the POST URL.

Add a base for calculation record.

## Path parameters

- `employmentId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Request body

- BasesForCalculationGetPost
  - `id` string, uuid: The unique identifier of an object (GUID/UUID)
  - `startDate` string, date: The date on which this base starts. A (linked chain)[./#section/Data/Date-chains] per base is maintained within this resource. So multiple bases can be active at the same time but one specific base can never be active multiple times at the same time.
  - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
  - `deviations` object, nullable: Only set a value for the underlying fields if you want to deviate from the values as defined by the selected `base`. Set `deviations` to null if no deviations apply. Deviating is done on either all the fields or none.
    - `percentage` number, double: Deviation from the percentage
    - `reservationPercentage` number, double: deviation from the reservation percentage
    - `financialReservationPercentage` number, double: deviation from the financial reservation percentage
  - `ageBasedMinimum` object: This fields indicates how the age based minimum is applied
    - `key` integer: The number for the ageBasedMinimum
    - `value` string: The description of the ageBasedMinimum
  - `ageBasedMaximum` object: This fields indicates how the age based maximum is applied
    - `key` integer: The number for the ageBasedMaximum
    - `value` string: The description of the ageBasedMaximum
  - `base` object: `base` is a metadata field within the payroll administration context. Possible values can be managed by the user.
    - `key` integer: The number for the base
    - `value` string: The description of the base

## Response `201`

Created

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `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
  - `content` BasesForCalculationGetPost
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: The date on which this base starts. A (linked chain)[./#section/Data/Date-chains] per base is maintained within this resource. So multiple bases can be active at the same time but one specific base can never be active multiple times at the same time.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `deviations` object, nullable: Only set a value for the underlying fields if you want to deviate from the values as defined by the selected `base`. Set `deviations` to null if no deviations apply. Deviating is done on either all the fields or none.
      - `percentage` number, double: Deviation from the percentage
      - `reservationPercentage` number, double: deviation from the reservation percentage
      - `financialReservationPercentage` number, double: deviation from the financial reservation percentage
    - `ageBasedMinimum` object: This fields indicates how the age based minimum is applied
      - `key` integer: The number for the ageBasedMinimum
      - `value` string: The description of the ageBasedMinimum
    - `ageBasedMaximum` object: This fields indicates how the age based maximum is applied
      - `key` integer: The number for the ageBasedMaximum
      - `value` string: The description of the ageBasedMaximum
    - `base` object: `base` is a metadata field within the payroll administration context. Possible values can be managed by the user.
      - `key` integer: The number for the base
      - `value` string: The description of the base

## 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)