Get state totals
get_state_totalsRead-only
Get a state's total returns, individuals, AGI, average AGI, income tax, total tax liability, and AGI distribution across six income brackets.
Instructions
State-level SOI totals and AGI distribution from the IRS state rollup.
`state`: a 2-letter USPS code (e.g. 'CA') or full state name (e.g.
'California'). Returns the state's total returns, individuals, AGI, average
AGI per return, income tax, total tax liability, and the income distribution
across the six AGI brackets. Drawn from the IRS 00000 state-total row.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | 2-letter USPS state code | |
| returns | No | Total returns in the state | |
| brackets | Yes | The state's income distribution across the six AGI brackets | |
| tax_year | Yes | SOI tax year of the data | |
| income_tax | No | Total income tax amount | |
| individuals | No | Total individuals (filers plus dependents) | |
| avg_agi_per_return | No | AGI divided by the number of returns | |
| total_tax_liability | No | Total tax liability amount | |
| adjusted_gross_income | No | Total adjusted gross income (AGI) |