Reference
A human field guide to the product archives The Ledger renders. Use it with the data cache and tools guide. This is not a live query API or a machine JSON Schema server.
The Books
Multi-year state ledger of federal revenue and spending used for rankings, map, politics, and compare.
Download: /downloads/books/federal-balance.json
types/federal-balance.ts · StateFederalBalance, DatasetMeta
| Field | Meaning |
|---|---|
| years[YYYY].states[] | One state row per fiscal data year. |
| state / abbreviation | Display name and two-letter code. |
| federalRevenue / federalSpending | Primary OSC-derived dollar totals for the year. |
| population | Population used for per-capita views. |
| dataYear | Archived fiscal data year for the row. |
| meta | Publisher, report title, access date, placeholder flag. |
The Books
National receipt composition, CBO budget tables, and USAspending agency profiles / awards.
Download: /downloads/books/revenue.json
types/flow-data.ts · RevenueDataset, CongressDataset, AgenciesDataset
| Field | Meaning |
|---|---|
| revenue.json | MTS-style receipt rollups and composition views. |
| congress.json | CBO historical / baseline budget series and revenue detail. |
| agencies.json profiles[] | Agency slug, name, and award/outlay context. |
| agencies.json awards / outlays | Obligation or outlay tables tied to profiles when present. |
The Floor
Featured full-detail bills plus congress inventory (issues-inventory.json) for atlas mode.
Download: /downloads/floor/issues.json
types/issues.ts · IssueBill, IssuesDataset
| Field | Meaning |
|---|---|
| issues[] | Featured full-detail bills in issues.json. |
| issues-inventory.json | Slim Congress.gov list rows for covered congresses. |
| featured / detailLevel | Start-here overlay vs index-only inventory row. |
| congress / billType / billNumber | Congress.gov identity (e.g. hr 1). |
| stages[] / currentStage | Pipeline progress (full detail on Featured). |
| houseVotes[] / senateVotes[] | Roll calls on Featured bills when archived. |
| meta.coverageMode / inventoryCount | Atlas inventory coverage fields. |
The Gavel
Merits-focused SCOTUS archive: cases, opinion clusters, arguments, and justice credits.
Download: /downloads/gavel/gavel.json
types/gavel.ts · GavelCase, GavelJustice, GavelDataset
| Field | Meaning |
|---|---|
| cases[] | Merits cases with slug, docket number, term, and status. |
| caseName / label | Court and display names. |
| opinions[] / arguments[] | Opinion clusters and argument metadata when archived. |
| justices[] | Sitting justice records with authored / joined counts. |
| citations[] | Reporter citations when available. |
The Desk
Administrations, Featured actions, and FR PRESDOCU inventory (desk-actions-inventory.json).
Download: /downloads/desk/desk.json
types/desk.ts · DeskPresidency, DeskAction, DeskDataset
| Field | Meaning |
|---|---|
| presidencies[] | Ordinal administration spine with party and term dates. |
| actions[] | Featured EO / proclamation / memorandum rows in desk.json. |
| desk-actions-inventory.json | FR PRESDOCU inventory for modern admins. |
| featured / detailLevel | Start-here overlay vs index-only inventory row. |
| kind / documentNumber | Instrument type and FR-style document id when known. |
| presidencySlug | Join key from action to administration. |
| meta.coverageMode / inventoryCount | Atlas inventory coverage fields. |
The Race
Federal election finance and popular-vote archives for President, Senate, and House. Served via API because the file is large.
Download: /api/downloads/race
types/race.ts · RaceCandidate, RaceSeat, RaceDonorEntity, RaceDataset
| Field | Meaning |
|---|---|
| cycles[] | Election cycles present in the archive. |
| candidates[] | Candidate finance rows with office, state, cycle, FEC id. |
| totals | Receipts, disbursements, optional cash-on-hand. |
| result / primaryResult | Popular-vote attachments when a source matched. |
| seats[] | Seat labels for P/S/H contests. |
| donors[] | Committee (and related) donor entities with recipients. |
For counting rules and caveats, read methodology. For reuse and attribution, read usage. Agents should start at /llms.txt.