Get deductions by ZIP
get_deductionsRead-only
Retrieve standard and itemized deduction amounts, SALT deduction, and itemization rates for any U.S. ZIP code using IRS data.
Instructions
Deduction measures for a ZIP: standard vs. itemized, plus SALT.
`zip_code`: a 5-digit US ZIP. Returns the count and amount of standard
deductions and itemized deductions, the taxes-paid (SALT) deduction, and the
percent of returns that itemized. Amounts in USD.
Note: a 0 may be IRS-suppressed (<20 returns in each AGI-bracket cell)
rather than a true zero — it does not prove no one in the ZIP itemizes.
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 | |
| salt_amount | No | Taxes-paid (SALT) deduction amount | |
| salt_returns | No | Number of returns with the taxes-paid (SALT) deduction | |
| itemizing_pct | No | Percent of returns that itemized rather than took the standard deduction (0-100) | |
| itemized_amount | No | Total itemized deductions amount | |
| itemized_returns | No | Number of returns with itemized deductions | |
| standard_deduction_amount | No | Standard deduction amount | |
| standard_deduction_returns | No | Number of returns claiming the standard deduction |