Get State Tax Requirements

get https://api.gusto-demo.com/v1/companies/{company_uuid}/tax_requirements/{state}

Get all tax requirements for a given state.

Metadata Examples

{
  "type": "select",
  "options": [
    { "label": "Semiweekly",  value: "Semi-weekly" },
    { "label": "Monthly",  value: "Monthly" },
    { "label": "Quarterly",  value: "Quarterly" },
  ]
}

{
  "type": "radio",
  "options": [
    { "label": "No, we cannot reimburse",  value: false, short_label: "Not Reimbursable" },
    { "label": "Yes, we can reimburse",  value: true, short_label: "Reimbursable" },
  ]
}

{
  "type": "account_number",
  "mask": "######-##',
  "prefix": null
}

{
  "type": "tax_rate",
  "validation": {
    "type": "min_max",
    "min": "0.0004",
    "max": "0.081"
  }
}

scope: company_tax_requirements:read

Responses

Response body

object

company_uuid

string

state

string

One of the two-letter state abbreviations for the fifty United States and the District of Columbia (DC)

requirement_sets

array of objects

requirement_sets

object

state

string

One of the two-letter state abbreviations for the fifty United States and the District of Columbia (DC)

key

string

An identifier for a set of requirements. A list of requirement sets can contain multiple sets with the same key and different effective_from values.

label

string

Customer facing label for the requirement set, e.g. "Registrations"

effective_from

string | null

An ISO 8601 formatted date representing the date values became effective. Some requirement sets are effective dated, while others are not. Multiple requirement sets for the same state/key can/will exist with unique effective dates. If a requirement set is has an effective_from value, all requirement sets with the same key will also have an effective_from value.

requirements

array of objects

requirements

object

key

string

An identifier for an individual requirement. Uniqueness is guaranteed within a requirement set.

applicable_if

array of objects

An array of references to other requirements within the requirement set. This requirement is only applicable if all referenced requirements have values matching the corresponding value. The primary use-case is dynamically hiding and showing requirements as values change. E.g. Show Requirement-B when Requirement-A has been answered with false. To be explicit, an empty array means the requirement is applicable.

applicable_if

object

key

string

An identifier for an individual requirement. Uniqueness is guaranteed within a requirement set.

value

The required value of the requirement identified by key

label

string

A customer facing description of the requirement

description

string

A more detailed customer facing description of the requirement

value

string

The "answer"

metadata

object

404

Not Found

The requested resource does not exist. Make sure the provided ID/UUID is valid.

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.gusto-demo.com/v1/companies/company_uuid/tax_requirements/state \
3
     --header 'accept: application/json'


xxxxxxxxxx
89
}
1
{
2
  "company_uuid": "6c14eac3-0da2-474d-bda1-786b3602d381",
3
  "state": "GA",
4
  "requirement_sets": [
5
    {
6
      "state": "GA",
7
      "key": "registrations",
8
      "label": "Registrations",
9
      "effective_from": null,
10
      "requirements": [
11
        {
12
          "key": "71653ec0-00b5-4c66-a58b-22ecf21704c5",
13
          "applicable_if": [],
14
          "label": "Withholding Number",
15
          "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 <a target='_blank' data-bypass href='https://gtc.dor.ga.gov/_/#1'>register the business online</a>. The last two characters of your ID must be upper case letters.",
16
          "value": "1233214-AB",
17
          "metadata": {
18
            "type": "text"
19
          }
20
        },
21
        {
22
          "key": "6c0911ab-5860-412e-bdef-6437cd881df5",
23
          "applicable_if": [],
24
          "label": "DOL Account Number",
25
          "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 <a target='_blank' data-bypass href='https://support.gusto.com/hc/en-us/articles/210139038#registerdol'>follow the instructions here</a> to register your business with the Georgia Dept. of Labor.",

200OK