Get income by ZIP
get_incomeRead-only
Fetches adjusted gross income, average per return, and income components (wages, interest, dividends, business income, capital gains) for any U.S. ZIP code from IRS SOI data.
Instructions
Income measures for a ZIP: AGI, average AGI per return, and components.
`zip_code`: a 5-digit US ZIP. Returns total adjusted gross income (AGI),
average AGI per return, and the main income components — salaries and wages,
taxable interest, ordinary dividends, business net income, and net capital
gain. All dollar amounts in USD.
Note: figures cover filed tax returns only. Average AGI is a *mean per
return*, not a median per household, and AGI omits most nontaxable income —
so it is not directly comparable to Census median household income.
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 | |
| total_income | No | Total income amount | |
| net_capital_gain | No | Net capital gain (less loss) amount | |
| taxable_interest | No | Taxable interest amount | |
| avg_agi_per_return | No | AGI divided by the number of returns | |
| ordinary_dividends | No | Ordinary dividends amount | |
| salaries_and_wages | No | Salaries and wages amount | |
| business_net_income | No | Business or professional net income (less loss) amount | |
| adjusted_gross_income | No | Total adjusted gross income (AGI) |