---
title: "List of all the leave policies"
method: GET
path: "/v2/providers/employers/{employerId}/leavePolicies"
tags: ["Leave policy"]
---

# List of all the leave policies

`GET /v2/providers/employers/{employerId}/leavePolicies`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/{employerId}/leavePolicies`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/GetLeavePoliciesByEmployerId" target="_blank">GetLeavePoliciesByEmployerId</a> <br/>  <br/>  Returns all the leave policies for the given employer.

## 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` LeavePolicy[]
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `name` string: The name of the leave policy
    - `leaveUnitType` object: Indicates what the unit type (hours or days) is. Employments linked to this leave policy use this leaveUnitType for their leave.
      - `key` integer: The key for the unit type
      - `value` string: The description for the leave unit type
    - `roundTo` object: Indicates to how many digits after the decimal point to round the numbers
      - `key` integer: The key for the roundTo
      - `value` string: The description for the roundTo
    - `roundingMethod` object: Indicates how to round the numbers
      - `key` integer: The key for the roundingMethod
      - `value` string: The description for the roundingMethod
    - `accrualType` object: Indicates how leave is accrued (yearly, monthly or hourly)
      - `key` integer: The key for the `accrualType`
      - `value` string: The description for the `accrualType`
    - `dayOfTheMonthToPerformAutomaticLeaveCalculationOn` integer, nullable: They day of the month on which the automatic accrual of (yearly or monthly) leave is performed. The yearly calculation is repeated every month to encompase any changes made that have affect on the past. If for example 31 is chosen and a specific month does not have that day the logic will pick the first available date of said month.
    - `payoutLeaveImmediately` boolean: If leave `accrualType` is set to based on hours worked (uren) then this field allows for the leave hours to be paid out directly instead of being accrued.
    - `leaveEntitlement` object, nullable
      - `statutory` number, double, nullable: The statutory leave (wetelijk verlof) linked employments are entitled to for a full time contract.
      - `excessLeaveToStatutory` number, double, nullable: The excess leave (bovenwetelijk verlof) linked employments are entitled to for a full time contract.
      - `wtr` number, double, nullable: The wrt leave (ADV/ATV verlof) linked employments are entitled to for a full time contract.
    - `leaveRequest` object
      - `applyLeaveSchedule` boolean: Indicates whether the leave schedule can be enterd and is so it is used when calculating the sugested leave hours for a leave request
      - `useHolidaysInCalculation` boolean: Indicates whether the calculating for sugested leave hours for a leave request takes into account holidays. Is set to true no leave hours are calculated for "The historical date on which the employee was first employed. This field is used when an employee has multiple employments in time. In most cases this field should be used as the date on which the employee started working for the company." eg. When requesting leave for the 24th and 25th of december (25th being a national holiday) the calculation (8 hours a day) will return 8 when `useHolidaysInCalculation` is true and 16 when `useHolidaysInCalculation` is false
      - `leavePattern` object, nullable: The applicable leave pattern for a period of 2 weeks can be stored in this object. Each field contains the number of leave(work) hours for that day in the 2-week period. <br /> Please note that the `leavePattern` should be left NULL if no data is present (as opposed to filling all fields with 0) <br /> Each field represent the number of hours the employee normally works on that day.
        - `oddWeeks` object
          - `monday` number, double
          - `tuesday` number, double
          - `wednesday` number, double
          - `thursday` number, double
          - `friday` number, double
          - `saturday` number, double
          - `sunday` number, double
        - `evenWeeks` object
          - `monday` number, double
          - `tuesday` number, double
          - `wednesday` number, double
          - `thursday` number, double
          - `friday` number, double
          - `saturday` number, double
          - `sunday` number, double
    - `additionalLeave` object
      - `allocationType` object: Indicates how additional leave is to be assigned to the employments (linked to this leave policy).
        - `key` integer: The key for the `additionalLeaveAllocationType`
        - `value` string: The description for the `additionalLeaveAllocationType`
      - `referenceDate1` object: If `referenceDate2` has a value only the last 6 months of the year are allowed as values
        - `month` object: The month of the first reference date
          - `key` integer: The key for the `referenceMonth`
          - `value` string: The description for the `referenceMonth`
        - `day` integer: The day of the first reference date.
      - `referenceDate2` object, nullable: Only use if applicable
        - `month` object: The month of the second reference date
          - `key` integer: The key for the `referenceMonth`
          - `value` string: The description for the `referenceMonth`
        - `day` integer: The day of the second reference date.

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