---
title: "Post leave for multiple employments."
method: POST
path: "/v2/providers/employers/{employerId}/leave"
tags: ["Collective leave"]
---

# Post leave for multiple employments.

`POST /v2/providers/employers/{employerId}/leave`

## Request

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

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

Post leave for a set of employments under an employer.

__Metadata :__ There is no metadata endpoint for this resource.

__Defaults :__ Defaults are available at /defaults.

## Path parameters

- `employerId` string, uuid, required

## Headers

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

## Request body

- Leave2[]
  - `employmentId` string, uuid: The unique identifier of an object (GUID/UUID)
  - `startDate` string, date: The start date for the leave.
  - `endDate` string, date: The end date for the leave.
  - `leaveType` integer: The id of the leavetype.
  - `isAccrual` boolean: Indicates whether the leave should be added(true) or subtracted(false).
  - `numberOfUnits` number, double: The amount of leave.
  - `comments` string, nullable: Any comments on the leave.

## Response `202`

OK. the specified leave is applied to the selected employments.

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