---
title: "Update payroll run status Collective"
method: PATCH
path: "/v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns"
tags: ["Review payroll run"]
---

# Update payroll run status Collective

`PATCH /v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/payrolladministrations/payrollperiods/{payrollPeriodId}/payrollruns`
- Auth: none required

__Activity name :__ PatchApprovePayrollRunCollectiveByBearerToken This is a controller endpoint to perform an action.

* The endpoint patches multiple payrollruns within one provider.
* Only one payrollrun per payrolladministration can be patched.
* Is endpoint is similar to PatchPayrollRunByPayrollRunIds except for the ids it works with and its progress which can be monitored.

## Path parameters

- `payrollPeriodId` integer, required

## Headers

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

## Request body

- PatchPayrollRunCollective[]
  - `payrollAdministrationId` string, uuid: The unique identifier of an object (GUID/UUID)

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