Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Tax Requirements

Get tax requirements for a state

Retrieves the detailed tax requirements for a specific state. The response includes requirement sets grouped by category (e.g., registrations, tax rates, deposit schedules), each containing individual requirements with their current values, labels, and metadata describing the expected input format.

Use this to build dynamic UIs for tax setup or to read the current tax configuration for a state.

scope: company_tax_requirements:read

get/v1/companies/{company_uuid}/tax_requirements/{state}

Path parameters

company_uuidstring required

The UUID of the company

statestring required

The two-letter state abbreviation

Query parameters

schedulingboolean

When true, return "new" requirement sets with valid effective_from dates that are available to save new effective-dated values.

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

company_uuidstring
statestring

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

Example response

{
  "state": "GA",
  "requirement_sets": [
    {
      "state": "GA",
      "key": "registrations",
      "effective_from": "2022-01-01",
      "requirements": [
        {
          "key": "71653ec0-00b5-4c66-a58b-22ecf21704c5",
          "applicable_if": [
            {
              "key": "71653ec0-00b5-4c66-a58b-22ecf21704c5"
            }
          ]
        }
      ]
    }
  ]
}