How Do We Calculate?

Where the numbers come from and how we crunch them.

Where does the data come from?

Every day Congress is in session, the U.S. Government Publishing Office publishes something called the Congressional Record Daily Digest — an official summary of what each chamber actually did that day, including the exact times they gaveled in, took breaks, and adjourned.

We pull that text automatically from the GovInfo API, a free public data service run by the federal government. The data updates daily.

How do we turn text into numbers?

The Daily Digest is written in plain English, not a spreadsheet. So we feed each day's text to an AI model (Claude), which reads it and pulls out the key facts: when the session started, when it ended, how long any recesses were, and how many votes were taken.

We then do a quick sanity check on every number the AI returns — making sure the math adds up — before saving anything to the database.

How are hours worked calculated?

Hours worked = time gaveled in → time adjourned, minus any recesses taken during that session. We call those "breaks" — the periods where Congress formally paused before resuming. The result is net time actually in session.

We never count pro forma sessions (see below) or days they simply weren't there.

What counts as a real work day vs. a day off?

We retain both real sessions and brief appearances in the day-by-day log. The dashboard measures substantive work, not attendance alone.

  • Showed Up — a real session was held with actual legislative work: debating bills, confirming nominations, casting votes, or conducting other official business.
  • Brief Appearance — a pro forma session. Congress technically convened — sometimes for as little as 30 seconds — but conducted no real business. This is a constitutional workaround that prevents the President from making recess appointments. These sessions appear in the data but do not count toward working days or hours worked. A weekday brief appearance counts toward the dashboard's “Days Off” total because no substantive work session was held.
  • Days Off — verified weekdays without a substantive work session: either no session was held or only a brief appearance occurred. Brief appearances remain separately labeled in the log. A missing or failed source download is not evidence of a day off.

What about weekends and holidays?

Only weekdays (Monday–Friday) can count as days off. Real weekend work sessions do count toward working days and hours. Weekend brief appearances remain recorded but count neither as real work nor as days off. The full-year calendar breakdown counts each weekend date once, even when a session occurred.

Federal holidays, including observed dates and Inauguration Day in Washington, and full-day presidential closure dates are exempt when no substantive work was recorded. Work on a holiday still counts as work. Half-day closures remain ordinary weekdays. The totals end at the latest verified published Record, shown below each chamber's cards.

Why do the Senate and House numbers differ?

The Senate and House are separate chambers with separate schedules. They vote independently, take breaks independently, and often work different hours on the same day. We track each chamber separately and show their totals side by side.

How is the weekly average calculated?

We divide each chamber's total hours worked by the number of weeks that have passed so far this calendar year (counted from January 1). That gives us a per-week rate for the Senate and a separate one for the House. The number shown on the home page is the average of those two rates.

Is this official data?

The source is official — the Congressional Record is the authoritative record of congressional proceedings. The extraction is automated and AI-assisted, which means occasional errors are possible. We apply validation rules to catch the most common mistakes, but this site is meant to give you a clear picture, not a certified audit.