---
title: "Get an employee's state taxes"
method: GET
path: "/v1/employees/{employee_uuid}/state_taxes"
tags: ["Employee Tax Setup"]
---

# Get an employee's state taxes

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

Get attributes relevant for an employee's state taxes.

The data required to correctly calculate an employee's state taxes varies by both home and work location. This API returns information about each question that must be answered grouped by state. Mostly commonly, an employee lives and works in the same state and will only have questions for a single state. The response contains metadata about each question, the type of answer expected, and the current answer stored in Gusto for that question.

Answers are represented by an array. Today, this array can only be empty or contain exactly one element, but is designed to allow for forward compatibility with effective-dated fields. The `valid_from` and `valid_up_to` fields are optional and currently ignored.

## About filing new hire reports
Payroll Admins are responsible for filing a new hire report for each Employee. The `file_new_hire_report` question will only be listed if:
- the `employee.onboarding_status` is one of the following:
  - `admin_onboarding_incomplete`
  - `self_onboarding_awaiting_admin_review`
- that employee's work state requires filing a new hire report

scope: `employee_state_taxes:read`

## Path parameters

- `employee_uuid` string, required

## Headers

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

## Response `200`

successful

- object[]
  - `uuid` string — The uuid of the employee state field.
  - `employee_uuid` string — The employee's uuid
  - `state` string — Two letter US state abbreviation
  - `file_new_hire_report` boolean, nullable
  - `is_work_state` boolean
  - `questions` EmployeeStateTaxQuestion[]
    - `label` string, required — A short title for the question
    - `description` string, nullable, required — An explaination of the question - this may contain inline html formatted links.
    - `key` string, required — A unique identifier of the question (for the given state) - used for updating the answer.
    - `is_question_for_admin_only` boolean, required
    - `input_question_format` EmployeeStateTaxInputQuestionFormat, required
      - `type` string, required — Describes the type of question - Text, Number, Select, Currency, Date
      - `options` object[] — For "Select" type questions, the allowed values and display labels.
        - `value` union — An allowed value to answer the question
          - string
          - boolean
          - number
        - `label` string, required — A display label that corresponds to the answer value
    - `answers` EmployeeStateTaxAnswer[], required
      - `value` union — The answer to the corresponding question - this may be a string, number, boolean, or null.
        - string
        - number
        - boolean
      - `valid_from` string — The effective date of the answer - currently always “2010-01-01”.
      - `valid_up_to` string, nullable — The effective end date of the answer - currently always null.

## Other responses

- `404` — Not Found

---

[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)