Get filing status by ZIP
get_filing_statusRead-only
Retrieve filing status breakdown for any U.S. ZIP code: counts of single, married-joint, head-of-household returns, plus elderly filers and e-file share.
Instructions
Filing-status mix for a ZIP: single / married-joint / head-of-household.
`zip_code`: a 5-digit US ZIP. Returns the number of single, married-filing-
jointly, and head-of-household returns, the number of elderly returns (age
65+), and the count and share of electronically filed returns.
Note: a 0 count may be IRS-suppressed (<20 returns in each AGI-bracket
cell) rather than truly absent.
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 | |
| zipcode | Yes | 5-digit ZIP code | |
| tax_year | Yes | SOI tax year of the data | |
| total_returns | No | Total number of returns | |
| single_returns | No | Single returns | |
| elderly_returns | No | Returns with the taxpayer aged 65 or older | |
| married_joint_returns | No | Married-filing-jointly returns | |
| electronically_filed_pct | No | Percent of returns filed electronically (0-100) | |
| head_of_household_returns | No | Head-of-household returns | |
| electronically_filed_returns | No | Electronically filed returns |