---
title: "Bulk update pay stubs"
method: POST
path: "/pay_stubs/bulk/update"
tags: ["Pay Stubs"]
---

# Bulk update pay stubs

`POST /pay_stubs/bulk/update`

Bulk-update the pay stubs under the given payroll matching the selection criteria. The payroll must be in `draft` status.

## Request body

- object
  - `payroll_id` string, required — The payroll whose pay stubs to update.
  - `pay_stubs` object, required — The pay stub selection criteria. `pay_stubs.include` must be either the string `"all"`, or an object containing one or more of `ids` (pay stub id string array), `work_assignment_ids` (string array - selects the stubs for those work assignments), `payee_type` (`employee` or `contractor`). `pay_stubs.exclude` (optional) is an object containing one or more of the same keys.
    - `exclude` object
      - `ids` string[]
      - `payee_type` 'contractor' | 'employee'
      - `work_assignment_ids` string[]

## Response `202`

Accepted

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/versions/01cd9c45a923/schema)