Get filing status by ZIP
get_filing_statusRead-only
Retrieve filing status distribution for any U.S. ZIP code, including single, married-joint, head-of-household, elderly returns, and e-file counts. Use IRS data to analyze tax filing patterns.
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"zip_code": "<zip_code>"
},
"name": "get_filing_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output 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 |