---
title: "Worker State Tax"
method: PATCH
path: "/workers/{workerId}/statetaxes"
tags: ["Worker"]
---

# Worker State Tax

`PATCH /workers/{workerId}/statetaxes`

## Request

- Base URL: `https://api.paychex.com`
- URL: `https://api.paychex.com/workers/{workerId}/statetaxes`
- Auth: none declared
- TypeScript: <https://skmtc.dev/paychex/apis/external-api/docs/workers/:workerId/statetaxes/patch.ts> (a function with typed inputs; its response is checked against the schema)

<h3>Add and Replace existing state tax data for a given worker</h3>

## Path parameters

- `workerId` string, required

## Request body

- StateTaxFieldsDescription
  - `countrySubdivisionCode` string: The state abbreviation for a given state tax
  - `stateAllocationPercent` string: The percentage of a worker's income to be applied to this state tax
  - `isResidentState` string: Whether this worker is a resident in this state
  - `taxStatusType` string: The withholding status for this state tax
  - `filingStatusType` string: The filing status of the worker for this state tax
  - `additionalAmount` number: See state tax documentation
  - `additionalPercent` integer: See state tax documentation
  - `flatDollarOverride` number: See state tax documentation
  - `overridePercent` number: See state tax documentation

## Response `200`

Successful PATCH operation

- object
  - `content` StateTaxResponse
    - `workerTaxId` string
    - `countrySubdivisionCode` string
    - `isResidentState` boolean
    - `stateAllocationPercent` integer
    - `regulationType` string
    - `taxStatusType` string
    - `filingStatusType` string
    - `additionalAmount` number, double
    - `additionalPercent` number, double
    - `overridePercent` number, double
    - `flatDollarOverride` number, double
    - `exemptionReasonDescription` string
    - `workerTaxDeductions` WorkerTaxDeductionResponse[]
      - `workerTaxDeductionId` object
      - `workerTaxDeductionName` string
      - `amount` integer
      - `quantity` number
  - `links` Link1[]
    - `href` string
    - `hreflang` string
    - `title` string
    - `type` string
    - `deprecation` string
    - `profile` string
    - `name` string
    - `templated` boolean

## Other responses

- `403`: User doesn't have access to this endpoint (API-2), Client has been end dated (API-68)
- `404`: Invalid resource ID (API-7)
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/paychex/apis/external-api.md) - [All operations](https://skmtc.dev/paychex/apis/external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paychex/apis/external-api/revisions/07161d3e073f?raw)