Get an employee's state taxes

GET {{baseUrl}}/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. Until effective dated answers are supported, the valid_from and valid_up_to must always be "2010-01-01" and null respectively.

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

HEADERS

RESPONSES

status: OK

{"employee_uuid":"92fa4d30-e284-43d0-a26e-605619c04beb","file_new_hire_report":false,"is_work_state":true,"state":"CA","questions":[{"label":"Filing Status","description":"The Head of Household status applies to unmarried individuals who have a relative living with them in their home. If unsure, read the \u003ca target='_blank' data-bypass rel='noopener noreferrer' tabindex='99' href='https://www.ftb.ca.gov/file/personal/filing-status/index.html'\u003eCA Filing Status explanation\u003c/a\u003e.\n","key":"filing_status","input_question_format":{"type":"Select","options":[{"value":"S","label":"Single"},{"value":"M","label":"Married one income"},{"value":"MD","label":"Married dual income"},{"value":"H","label":"Head of household"},{"value":"E","label":"Do Not Withhold"}]},"answers":[{"value":"S","valid_from":"2010-01-01","valid_up_to":null}]},{"label":"Withholding Allowance","description":"This value is needed to calculate the employee's CA income tax withholding. If unsure, use the \u003ca target='_blank' data-bypass rel='noopener noreferrer' tabindex='99' href='http://www.edd.ca.gov/pdf_pub_ctr/de4.pdf'\u003eCA DE-4 form\u003c/a\u003e to calculate the value manually.\n","key":"withholding_allowance","input_question_format":{"type":"Number"},"answers":[{"value":1,"valid_from":"2010-01-01","valid_up_to":null}]},{"label":"Additional Withholding","description":"You can withhold an additional amount of California income taxes here.","key":"additional_withholding","input_question_format":{"type":"Currency"},"answers":[{"value":"0.0","valid_from":"2010-01-01","valid_up_to":null}]},{"label":"File a New Hire Report?","description":"State law requires you to file a new hire report within 20 days of hiring or re-hiring an employee.","key":"file_new_hire_report","input_question_format":{"type":"Select"},"answers":[{"value":true,"valid_from":"2010-01-01","valid_up_to":null}]}]}