Get tax by ZIP
get_taxRead-only
Retrieve IRS tax statistics for a U.S. ZIP code, including income tax, total tax liability, and average per return.
Instructions
Tax measures for a ZIP: income tax, total liability, and average per return.
`zip_code`: a 5-digit US ZIP. Returns income tax, income tax before credits,
total tax liability (broader — includes self-employment tax and other taxes),
total tax payments, and the average total tax per return. Amounts in USD.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | 2-letter USPS state code | |
| returns | No | Number of returns | |
| zipcode | Yes | 5-digit ZIP code | |
| tax_year | Yes | SOI tax year of the data | |
| income_tax | No | Income tax amount (after credits, before other taxes) | |
| total_tax_payments | No | Total tax payments amount | |
| total_tax_liability | No | Total tax liability (broader than income tax: includes self-employment tax, recapture, etc.) | |
| avg_total_tax_per_return | No | Total tax liability divided by the number of returns | |
| income_tax_before_credits | No | Income tax before credits amount |