---
title: "Bulk update pay rates"
method: POST
path: "/pay_rates/bulk/update"
tags: ["Pay Rates"]
---

# Bulk update pay rates

`POST /pay_rates/bulk/update`

## Request body

- object
  - `business_entity_id` string, required
  - `work_assignments` object, required
    - `exclude` object
      - `ids` string[]
      - `payee_type` 'contractor' | 'employee'
      - `pay_schedule_id` string
      - `archived` boolean
      - `payee_names` string
  - `has_business_preset` boolean
  - `business_presets` object
    - `include` object
      - `ids` string[]
    - `exclude` object
      - `ids` string[]
  - `expense_accounting_codes` object
    - `include` object
      - `ids` string[]
    - `exclude` object
      - `ids` string[]
  - `liability_accounting_codes` object
    - `include` object
      - `ids` string[]
    - `exclude` object
      - `ids` string[]
  - `effective_on` string, date
  - `not_effective_on` string, date
  - `effective_from` string — The date from which this pay rate is applied to Pay Stubs. Date filters support two formats: Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD` format for an exact match. Example: `effective_from=2024-01-01` Use an array-like syntax to specify a range with one or more comparison operators: - `gt` (greater than) - `gte` (greater than or equal to) - `lte` (less than or equal to) - `lt` (less than) Example: `effective_from[gte]=2024-01-01&effective_from[lt]=2024-12-31`
  - `effective_to` string — The date after which this pay rate is no longer applied and can no longer be used to create Earning Line Items. `null` if the pay rate applies indefinitely. Date filters support two formats: Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD` format for an exact match. Example: `effective_to=2024-01-01` Use an array-like syntax to specify a range with one or more comparison operators: - `gt` (greater than) - `gte` (greater than or equal to) - `lte` (less than or equal to) - `lt` (less than) Example: `effective_to[gte]=2024-01-01&effective_to[lt]=2024-12-31`
  - `subtypes` object
    - `include` string[]
    - `exclude` string[]
  - `ids` object
    - `include` string[]
    - `exclude` 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)