Skip to content

Add IRS filing-season snapshots and annual geographic and W-2 data - #444

Open
MaxGhenis wants to merge 4 commits into
mainfrom
us-filing-season-2025-refresh
Open

MaxGhenis wants to merge 4 commits into
mainfrom
us-filing-season-2025-refresh

Conversation

@MaxGhenis

Copy link
Copy Markdown
Contributor

Sources

Chronicle can now compare the IRS filing seasons for tax years 2024 and 2025 through the same processing cycle. It also adds the IRS’s 2023 geographic data and three years of Form W-2 statistics.

IRS source Coverage
Filing-season Table 1 Cycles 21 and 30 for tax years 2024 and 2025. Each workbook reports 116 counts and amounts for all returns and 16 adjusted gross income bands. Each observation carries the IRS processing cutoff.
County data and congressional district data The county file supplies return counts and adjusted gross income for IRS county reporting areas. The district file supplies selected income and tax items by congressional district.
Form W-2 Table 4.B The 2021–23 workbooks report counts of returns and taxpayers with Social Security tips, dollar amounts for those tips, and traditional and Roth 401(k) contributions.

Verification

  • Compared all 7,888 filing-season observations with their workbook cells, including the conversion from thousands of dollars to dollars.
  • Retrieved all nine archived source files from R2 and matched each file’s SHA-256 and byte count to the publisher copy.
  • Built the seven packages together using the 2023 W-2 table. The bundle produced 44,001 facts and zero duplicate keys. Separate builds cover W-2 for 2021 and 2022.
  • Checked the global dimension-value register and ran 90 source, registration and regression tests.

Chronicle governance

Codex used the ledger-source-ingestor role. The filing-season tables count returns the IRS had initially processed by each cutoff. Consumers can choose how to use these filing-season counts alongside annual figures.

This draft awaits the ledger-source-fidelity and ledger-boundary reviews. The independent review job is 20261118-081851-review.

@MaxGhenis
MaxGhenis marked this pull request as ready for review November 19, 2026 01:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant