---
title: "List leave requests per employment (for calendar)"
method: GET
path: "/v2/providers/employers/{employerId}/employees/employments/calendar/revokeleaverequests"
tags: ["Calendar"]
---

# List leave requests per employment (for calendar)

`GET /v2/providers/employers/{employerId}/employees/employments/calendar/revokeleaverequests`

## Request

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

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

For a calendar, this endpoint return the revoke leave requests calendar items PER specific employment.

Please note: this endpoint only will return calendar items based on leave request with status 'geaccepteerd met intrekkingsverzoek.'.

This endpoint only returns objects for which the employment meets the filter settings set at the user level. Note that filter settings are set for a user <-> employer <-> client combination.

## Path parameters

- `employerId` string, uuid, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageNumber` integer
- `pageSize` integer
- `startDate` string, date, required
- `endDate` string, date, required

## 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` EmployerCalendarLeaveRequest[]
    - `employment` Employment3
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `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.
    - `employee` Employee3
      - `id` string, uuid: The unique identifier of an object (GUID/UUID)
      - `formattedName` string: Formatted name of the employee based on the value of `howToFormatLastName`
      - `firstName` string, nullable: The first name, given name, forename or Christian name as part of a persons personal name.
    - `department` Department2: 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
    - `calendar` object[]: A list of time periods for which leave request information is available.
      - `startDate` string, date: The first day of the period for which leave request information is available.
      - `endDate` string, date, nullable: The last day of the period for which leave request information is available.
      - `details` object, nullable: In the future this object describes the calendar item in more detail. For now this object will always be NULL.

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