Skip to main content

How TaxLoop Works

A complete guide to the five-stage civic budget accountability cycle, key terms, icons, and frequently asked questions.

🔄The Five-Stage Accountability Loop

TaxLoop creates a closed feedback loop between you and your elected representatives. Each stage builds on the last to ensure your voice is heard and your legislators are held accountable.

  • Preferences are submitted separately for each government level: Seattle, King County, WA State, and Federal.
  • The sliders start at the current official allocation — move them to show how you'd change the budget.
  • Your submission is private; only aggregated, anonymous results are shared with legislators.
  • Reports include mean, median, and distribution of allocations across all budget categories.
  • Legislator staff receive the report in a standardized PDF format they can reference during deliberations.
  • Individual responses are never shared — only neighborhood-level aggregates.
  • We pull roll-call votes from Congress.gov, LegiScan (state), and council minutes (local).
  • Each vote is scored as MATCH or DIVERGE based on whether it aligns with the neighborhood's top priorities.
  • Your per-legislator alignment score is a percentage: how often they voted in line with your preferences.
  • Category-by-category breakdown showing the difference between community preferences and the enacted budget.
  • Highlights where your legislator advocated for or against your neighborhood's priorities.
  • Available as an interactive dashboard and downloadable PDF.
  • Pulls actual expenditure data from USAspending.gov (federal), state fiscal databases, and local open-data portals.
  • The 'execution gap' measures the average percentage-point difference between budgeted and actual spending.
  • Closes the full accountability loop — preferences → votes → budget → spending.
🎚️Stage 1
📨Stage 2
🗳️Stage 3
📊Stage 4
🔍Stage 5

📖Glossary

Alignment Score

A percentage (0–100%) indicating how often a legislator's budget-related votes match your stated preferences. 70%+ is green (strong), 40–69% is orange (moderate), and below 40% is red (weak).

Execution Gap

The average percentage-point difference between the enacted budget and actual government spending. A gap of 0 means the government spent exactly what was budgeted.

Budget Category

Major spending areas like Public Safety, Transportation, Housing & Affordability, Education, etc. Each government level has its own set of categories based on its official budget structure.

Top Priorities

The 3 budget categories you care about most. TaxLoop gives extra weight to these when generating alignment reports and messaging.

Government Level

The layer of government: Seattle (city), King County (county), Washington State (state), or Federal (U.S. Congress). Each has its own budget cycle and set of legislators.

Budget Cycle

The time period a budget covers. Seattle uses annual fiscal years (e.g., FY2027), King County uses biennial cycles (2025–2026), WA State is biennial (2025–2027), and the federal government uses fiscal years (FY2027).

MATCH / DIVERGE

Tags on individual legislator votes. MATCH means the vote aligns with your neighborhood's priorities. DIVERGE means it goes against them.

Allocate Remaining

A tool on the Preferences page that distributes unallocated budget percentage using one of three strategies: Proportional (by baseline %), Priority-weighted (extra to your top 3), or Even split.

Historical Alignment

An alignment score computed by comparing a legislator's past budget-related votes against your current preferences. Shown as green rings on the Alignment Wheel.

Session Alignment

An alignment score computed after you submit preferences and new votes occur. Based on preferences you actually submitted. Shown as blue rings on the Alignment Wheel.

Alignment Wheel

A multi-ring visualization showing your alignment with a legislator across budget cycles. The outer ring represents the most recent cycle, inner rings show prior years. Blue = submitted preferences, Green = retroactive comparison.

Data Confidence

A badge indicating data reliability. "Verified" (green) = sourced from official records. "Estimated" (amber) = computed from available data. "Pilot" (orange) = demonstration data not yet validated.

Global Preferences

Meta-category preferences (like Education, Healthcare, Infrastructure) that automatically distribute to specific budget categories at each government level.

🏷️Icon & Symbol Guide

These icons appear throughout TaxLoop. Hover over any icon on other pages to see a tooltip explanation.

🎚️

Budget Slider

Drag left or right to change how much of the budget you want allocated to this category. The marker shows the current official allocation.

📊

Alignment Chart

Bar chart showing how closely a legislator's votes match your preferences. Green = strong alignment, orange = moderate, red = weak.

🗳️

Vote Tracking

Indicates that TaxLoop is monitoring legislative votes. Each vote gets a MATCH or DIVERGE tag based on your neighborhood's priorities.

📨

Report Delivery

Shows that an aggregate report has been or will be delivered to your legislator before budget hearings.

🔍

Execution Audit

Compares the enacted budget to actual spending. The execution gap metric shows how closely the government stuck to the plan.

✉️

Send Message

Opens the messaging tool to send a pre-drafted message to your legislator about your budget priorities.

Color Coding

Strong / Match (70%+)
Moderate (40–69%)
Weak / Diverge (<40%)
City (Seattle)
County (King Co.)
State (WA)
Federal (U.S.)

Frequently Asked Questions

Yes. Your individual preferences are never shared with legislators or anyone else. Only aggregated, anonymized neighborhood-level data is included in reports delivered to elected officials.
TaxLoop is currently available in three pilot areas: Seattle, WA (98108), Langley, WA (98260), and Roseburg, OR (97470/97471). Each area covers city, county, state, and federal government levels with real legislator data.
We identify budget-related votes for each legislator, compare each vote to your neighborhood's aggregate preferences, and calculate the percentage of votes that align. Each vote is weighted equally.
Ideally before your government body's budget deliberation period. TaxLoop will notify you when preference windows open for each government level. You can update your preferences at any time.
Yes. You can resubmit preferences as many times as you like before the aggregation deadline. Your most recent submission is the one included in the aggregate report.
Seattle: city open data portal. King County: county open data portal. WA State: legislative fiscal databases and LegiScan. Federal: Congress.gov for votes, USAspending.gov for execution data.
Some government levels haven't had budget votes yet in the current cycle. 'Pending' means TaxLoop is tracking the legislative session and will generate reports as soon as relevant data becomes available.
Go to the My Legislators page, click any legislator card to expand it, and use the 'Send Message' button. TaxLoop pre-generates a message based on your priorities that you can customize before sending via email or the legislator's official contact form.
Look for the Data Confidence badges next to scores and data points. Green "Verified" badges indicate data sourced from official government records (Congress.gov, state legislatures, city budget offices). Amber "Estimated" badges indicate computed values. Orange "Pilot" badges indicate demonstration data used during our beta period.
The Alignment Wheel shows your alignment with a legislator across multiple budget cycles. The outer ring is the most recent fiscal year, inner rings show prior years. Blue rings mean the score is based on preferences you actually submitted. Green rings mean the score was computed retroactively against your current slider positions.
Global Alignment lets you set high-level budget priorities (like "25% to Education") that automatically distribute to specific budget categories at each government level. This saves time compared to adjusting sliders individually for City, County, State, and Federal levels.
Vote data comes from Congress.gov (federal), state legislature websites, and local government records. Budget data comes from the Congressional Budget Office, USAspending.gov, state budget offices, and municipal finance departments. We cite specific sources with "as of" dates on every data point.

🗄️Data Sources

Federal

  • Congress.gov — roll-call votes, bill text, sponsor/cosponsor data
  • Congressional Budget Office (CBO) — federal budget data, projections, and cost estimates
  • USAspending.gov — enacted budget, actual expenditure, and federal spending data
  • ProPublica Congress API — additional legislative metadata

WA State

  • leg.wa.gov — Washington State Legislature bills, votes, and committee schedules
  • LegiScan — state bill tracking, vote records, and legislative sessions
  • WA State Fiscal Information — budget documents and spending reports

OR State

  • oregonlegislature.gov — Oregon Legislative Assembly bills, votes, and session data

MN State

  • revisor.mn.gov — Minnesota Legislature bills, statutes, and session data

King County

  • King County Open Data (Socrata) — budget and expenditure data
  • King County Council website — agendas, minutes, and vote records

Seattle

  • Seattle Open Data (Socrata) — city budget and spending data
  • Seattle City Council — legislation, vote records, and meeting minutes
  • Seattle Budget Office — adopted budgets and quarterly spending updates

City & County Budget Offices

  • Municipal finance departments — local budget documents, hearing schedules, and expenditure reports
  • County budget offices — adopted budgets, amendments, and quarterly spending data

Ready to close the loop?

Submit your budget preferences, track legislator votes, and hold your government accountable.