---
title: "Get the proposed number of leave hours for all employments of an employer"
method: GET
path: "/v2/providers/employers/{employerId}/leave/proposedleavehours"
tags: ["Leave"]
---

# Get the proposed number of leave hours for all employments of an employer

`GET /v2/providers/employers/{employerId}/leave/proposedleavehours`

## Request

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

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

Returns the numberOfHours (only in hours) calculated based on the employments working- hours/schedual 

__Note:__  The function will only work if the employment is either linked to no leave policy or linked to only leave policy(s) that use hours as the unit of leave.

Further more how the leave hours are calculated can be managed in the leave policy with the `applyLeaveSchedule` and `working hours` resource with the field `calculateUsingWorkPattern.leaveHours` The order is as follows. If calculateUsingWorkPattern.leaveHours is true the work patern from workinghours is used otherwise if applyLeaveSchedule is set to true the `leavePattern` is used otherwise the workinghours are used

## Path parameters

- `employerId` string, uuid, required

## Query parameters

- `startDate` string
- `endDate` string
- `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.
  - `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` ProposedLeaveHoursResponse[]
    - `employmentId` string, uuid: The unique identifier (a GUID/UUID)
    - `proposedLeaveHours` number, double: The proposed number of leave hours
    - `methodOfCalculation` string: Indicates which method was used to calculate the proposed leave hours.
    - `additionalInformation` string, nullable: Provides additional information on the calculation.

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