---
title: "Get federal taxes for an employee"
method: GET
path: "/v1/employees/{employee_uuid}/federal_taxes"
tags: ["Employee Tax Setup"]
---

# Get federal taxes for an employee

`GET /v1/employees/{employee_uuid}/federal_taxes`

Returns federal tax information for an employee. The response structure varies based on the w4_data_type (pre_2020_w4 or rev_2020_w4).

scope: `employee_federal_taxes:read`

## Path parameters

- `employee_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Successful

- union — Federal tax information for an employee. The response structure varies based on the w4_data_type field.
  - object — Federal tax information for employees using the pre-2020 W4 form.
    - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
    - `employee_uuid` string — The UUID of the employee.
    - `employee_id` integer — The internal ID of the employee.
    - `company_id` integer — The internal ID of the company.
    - `w4_data_type` 'pre_2020_w4', required — The version of w4 form.
    - `filing_status` string, nullable — It determines which tax return form an individual will use and is an important factor in computing taxable income. One of: - Single - Married - Head of Household - Exempt from withholding - Married, but withhold as Single
    - `federal_withholding_allowance` number, nullable — An exemption from paying a certain amount of income tax. May be null when filing_status is "Exempt from withholding".
    - `additional_withholding` string, required — An additional withholding dollar amount.
  - object — Federal tax information for employees using the revised 2020 W4 form.
    - `version` string, required — The current version of the object. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
    - `employee_uuid` string — The UUID of the employee.
    - `employee_id` integer — The internal ID of the employee.
    - `company_id` integer — The internal ID of the company.
    - `w4_data_type` 'rev_2020_w4', required — The version of w4 form.
    - `filing_status` string, nullable, required — It determines which tax return form an individual will use and is an important factor in computing taxable income. One of: - Single - Married - Head of Household - Exempt from withholding
    - `extra_withholding` string, nullable, required — An employee can request an additional amount to be withheld from each paycheck.
    - `two_jobs` boolean, nullable, required — If there are only two jobs (i.e., you and your spouse each have a job, or you have two), you can set it to true.
    - `dependents_amount` string, nullable, required — A dependent is a person other than the taxpayer or spouse who entitles the taxpayer to claim a dependency exemption.
    - `other_income` string, nullable, required — Other income amount.
    - `deductions` string, nullable, required — Deductions other than the standard deduction to reduce withholding.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)