---
title: "employee W4s"
method: GET
path: "/v{version}/companies/{id}/w4s"
tags: ["Company"]
---

# employee W4s

`GET /v{version}/companies/{id}/w4s`

Returns a list of paginated employee W4s for the company.<p>Scopes: export_payroll</p>

## Path parameters

- `id` string, required
- `version` string, required

## Query parameters

- `pay_group_id` string
- `employee_id` string
- `employee_start_id` string
- `employee_limit` integer

## Response `200`

OK

- 0PagedWrappedArrayCompanyEmployeeW4
  - `next_id` string — The id of the object next up after this set.
  - `data` DtosCompanyEmployeeW4[], required — An array containing the list of relevant objects.
    - `employee_id` string
    - `state_of_taxation` string
    - `state` DtosStateW4
      - `tax_fields` unknown
      - `filing_status` 'O' | 'S' | 'H' | 'M' | 'MS' | 'M1' | 'M2' | 'W' | 'NRA' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'NRS' | 'NRM' — [O: No Exemptions, H: Head of Household, S: Single, M: Married, MS: Married but withhold as single, M1: Married filing jointly, (one income or spouse does not have income), M2: Married filing jointly, (multiple incomes or spouse has income), W: Qualifying Widow(er), NRA: NonResident Alien, A: CT - Withholding Code A, B: CT - Withholding Code B, C: CT - Withholding Code C, D: CT - Withholding Code D, E: Exempt, F: CT - Withholding Code F, NRS: NonResident Single, NRM: NonResident Married]
      - `exemption` integer
      - `is_exempt` boolean
      - `additional_withholding_type` string — Only currently supported value: "Dollar"
      - `additional_withholding` number, double
    - `federal` DtosFederalW4
      - `filing_status` 'S' | 'M' | 'H' — [S: Single, M: Married, S: Married but withhold as single, H: Head of Household]
      - `is_exempt` boolean
      - `two_jobs_similar_pay` boolean — This checkbox corresponds to Step 2(c) on the 2020 Form W-4.
      - `children_under17` integer — This int corresponds to the first input in Step 3 on the 2020 Form W-4.
      - `other_dependents` integer — This int corresponds to the second input in Step 3 on the 2020 Form W-4.
      - `other_tax_credit` number, double — This number corresponds to the adjustment a person would make to Step 3 after computing the tax credit values for their dependents. Page 2 of the 2020 Form W-4 gives instructions to the employee how to calculate and adjust the value for Step 3.
      - `dependent_total_amount` number, double — This number corresponds to the Step 3 field on the 2020 Form W-4. It is the sum of the child tax credits, other dependent tax credits, and tax credit amounts
      - `other_income` number, double — This number corresponds to the Step 4(a) field on the 2020 Form W-4.
      - `deductions` number, double — This number corresponds to the Step 4(b) field on the 2020 Form W-4.
      - `extra_withholding` number, double — This number corresponds to the Step 4(c) field on the 2020 Form W-4.
      - `additional_withholding_type` string — Only currently supported value: "Dollar"
      - `additional_withholding` number, double
  - `error` string — Contains any error messages, if applicable.

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)