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

# Worker State Tax

`GET /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/get.ts> (a function with typed inputs; its response is checked against the schema)

Information about worker's state tax allocation.

## Path parameters

- `workerId` string, required

## Response `200`

Successful operation

- object
  - `metadata` MetadataResource
    - `contentItemCount` integer
    - `pagination` PaginationMetadataResource
      - `offset` integer
      - `limit` integer
      - `itemCount` integer
      - `total` integer
  - `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)