---
title: "Leave entitlement for an employment"
method: GET
path: "/v2/providers/employers/leavepolicies/{leavePolicyId}/employments/{employmentId}/leave/entitlement\""
tags: ["Leave policy entitlement"]
---

# Leave entitlement for an employment

`GET /v2/providers/employers/leavepolicies/{leavePolicyId}/employments/{employmentId}/leave/entitlement"`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/leavepolicies/{leavePolicyId}/employments/{employmentId}/leave/entitlement"`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/GetLeavePolicyEntitlementByLeavePolicyIdAndEmploymentId" target="_blank">GetLeavePolicyEntitlementByLeavePolicyIdAndEmploymentId</a> <br/>  <br/>  Returns the entitlement for each leave type, given a leavepolicy and year

## Path parameters

- `leavePolicyId` string, uuid, required
- `employmentId` string, uuid, required

## Query parameters

- `year` integer
- `month` integer
- `overridingEmploymentEndDate` string, date

## 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
  - `content` EntitlementMultiGetObject
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `leavePolicyEntitlement` object[]
      - `leaveType` object: The type of leave requested by the employee `leaveType` is a metadata field within the employer context. Possible values can be managed by the user.
        - `key` integer: The key for the leave type.
        - `value` string: The description for the leave type. Note that leave types can be overridden at the employer level. In these cases the description at the employer level takes precedence over the default description of the leave type.
      - `entitlement` number, double: The amount of leave units accrued for the leave type in the year
      - `entitlementAgeBasedLeave` number, double: The amount of leave units accrued for the leave type in the year
      - `entitlementWageBasedLeave` number, double: The amount of leave units accrued for the leave type in the year
      - `entitlementYearsOfServiceBasedLeave` number, double: The amount of leave units accrued for the leave type in the year

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