---
title: "Request year transition collective"
method: POST
path: "/year/providers/employers/payrolladministrations/years/{yearId}/requestyeartransition"
tags: ["Year transition"]
---

# Request year transition collective

`POST /year/providers/employers/payrolladministrations/years/{yearId}/requestyeartransition`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/year/providers/employers/payrolladministrations/years/{yearId}/requestyeartransition`
- Auth: none required

__Activity name :__ PostRequestYearTransitionCollectiveByBearerTokenAndYearId

This endpoint allows the user to request a year transition for several payroll administrations. 
The user can indicate if an email will be sent to the employees and the date on which the employee can access the yearendstatement.
During the year transition the given year will be closed and a new year will be opened.

## Path parameters

- `yearId` string, uuid, required

## Headers

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

## Request body

- YearTransitionCollective[]
  - `payrollAdministrationId` string, uuid: The unique identifier of an object (GUID/UUID)
  - `sentEssMail` boolean: Property that indicates if an email will be sent to the employees.
  - `dateAvailableEss` string, date, nullable: The date on which the employee can access the yearendstatement.

## Response `202`

Accepted

- object
  - `content` CollectiveAction2
    - `collectiveActionId` string, uuid: The unique identifier of an object (GUID/UUID)
    - `collectiveActionParentId` string, uuid: The parentId is used to link the collectiveAction to a parent collectiveAction.
    - `employerId` string, uuid: The employer for which the collectiveAction was submitted.
    - `payrollAdministrationId` string, uuid: The payroll administration for which the collectiveAction was submitted.
    - `submittedByUserId` string, uuid: The user who submitted the collectiveAction.
    - `submittedOn` string, date-time: Date-time when the collectiveAction was submitted.
    - `status` 'Completed' | 'NotStarted' | 'InProgress': status of the collectiveAction
    - `type` 'Werknemerloket' | 'Beloning': the type of collectiveAction
    - `itemCount` object: Summary of the items in the collective action.
      - `processedWithError` integer: The number of items in the collectiveAction that were processed unsuccessfully and resulted in an error.
      - `processed` integer: The number of items in the collectiveAction that were processed successfully without a warning.
      - `processedWithWarning` integer: The number of items in the collectiveAction that were processed successfully with a warning.
      - `total` integer: The total number of items in the collectiveAction.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `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)