Get State Tax Requirements
GET {{baseUrl}}/v1/companies/:company_uuid/tax_requirements/:state?scheduling=<boolean>
Get all tax requirements for a given state.
Metadata Examples
json select
{
"type": "select",
"options": [
{ "label": "Semiweekly", value: "Semi-weekly" },
{ "label": "Monthly", value: "Monthly" },
{ "label": "Quarterly", value: "Quarterly" },
]
}
json radio
{
"type": "radio",
"options": [
{ "label": "No, we cannot reimburse", value: false, short_label: "Not Reimbursable" },
{ "label": "Yes, we can reimburse", value: true, short_label: "Reimbursable" },
]
}
json account_number
{
"type": "account_number",
"mask": "######-##',
"prefix": null
}
json tax_rate
{
"type": "tax_rate",
"validation": {
"type": "min_max",
"min": "0.0004",
"max": "0.081"
}
}
scope: company_tax_requirements:read
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
scheduling | string | When true, return "new" requirement sets with valid effective_from dates that are available to save new effective dated values. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-Gusto-API-Version | string | Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used. | |
Accept | string |
RESPONSES
status: OK
{"company_uuid":"6c14eac3-0da2-474d-bda1-786b3602d381","state":"GA","requirement_sets":[{"state":"GA","key":"registrations","label":"Registrations","effective_from":null,"requirements":[{"key":"71653ec0-00b5-4c66-a58b-22ecf21704c5","applicable_if":[],"label":"Withholding Number","description":"If you have run payroll in the past in GA, find your withholding number on notices received from the Georgia Department of Revenue, or call the agency at (877) 423-6711. If you don’t have a number yet, you should \u003ca target='_blank' data-bypass href='https://gtc.dor.ga.gov/_/#1'\u003eregister the business online\u003c/a\u003e. The last two characters of your ID must be upper case letters.","value":"1233214-AB","metadata":{"type":"text"}},{"key":"6c0911ab-5860-412e-bdef-6437cd881df5","applicable_if":[],"label":"DOL Account Number","description":"If you have run payroll in the past in GA, find your DOL account number on notices received from the Georgia Department of Labor, or call the agency at (404) 232-3300. If you don’t have an account number yet, please \u003ca target='_blank' data-bypass href='https://support.gusto.com/hc/en-us/articles/210139038#registerdol'\u003efollow the instructions here\u003c/a\u003e to register your business with the Georgia Dept. of Labor.","value":"474747-88","metadata":{"type":"text"}}]},{"state":"GA","key":"taxrates","label":"Tax Rates","effective_from":"2022-01-01","requirements":[{"key":"e0ac2284-8d30-4100-ae23-f85f9574868b","applicable_if":[],"label":"Total Tax Rate","description":"Haven't received your assigned rate yet? \u003ca target='_blank' data-bypass href='https://support.gusto.com/article/106622236100000/State-unemployment-insurance-(SUI)-tax'\u003eFind the new employer rate\u003c/a\u003e and enter it here.","value":"0.05","metadata":{"type":"tax_rate","validation":{"type":"min_max","min":"0.0004","max":"0.081"}}}]},{"state":"GA","key":"depositschedules","label":"Deposit Schedules","effective_from":"2022-01-01","requirements":[{"key":"6ddfcbeb-94d3-4003-bfc2-8c6e1ca9f70c","applicable_if":[],"label":"Deposit Schedule","description":"Georgia rejects payments made on the wrong schedule. GA employers receive their schedule on a registration verification letter after registering with the Georgia Dept. of Revenue. If you are unsure, call the agency at (877) 423-6711. If you did not register your business yet, please \u003ca target='_blank' data-bypass href='https://gtc.dor.ga.gov/_/#2'\u003eregister the business with the Georgia Dept. of Revenue\u003c/a\u003e.","value":"Semi-weekly","metadata":{"type":"select","options":[{"label":"Semiweekly","value":"Semi-weekly"},{"label":"Monthly","value":"Monthly"},{"label":"Quarterly","value":"Quarterly"}]}}]}]}