Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Tax Requirements

Get all tax requirements for a company

Retrieves all states for which a company has tax requirements, along with a boolean indicating whether tax setup is complete for each state. Use this to determine which states still need tax setup during company onboarding.

scope: company_tax_requirements:read

get/v1/companies/{company_uuid}/tax_requirements

Path parameters

company_uuidstring required

The UUID of the company

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

statestring

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

setup_status'not_started' | 'in_progress' | 'complete'

The current status of the state tax setup.

  • not_started: No requirements have been filled
  • in_progress: Some requirements have been filled, or default rates are applied
  • complete: All requirements have been filled without default rates
default_rates_appliedboolean

Whether the state is using system-assigned default SUI rates rather than employer-specific rates.

ready_to_run_payrollboolean

Whether the state tax setup is sufficiently complete for the company to run payroll.

Example response

[
  {
    "state": "GA"
  }
]