Skip to content

jeffpar/argument-aloud

Repository files navigation

Argument Aloud

For The Sake of Argument

Every U.S. Supreme Court case ends in a decision, but it starts with arguments, and those arguments come in many forms: the initial petition, a series of briefs, and then usually oral arguments, all of which have been recorded since October 1955 and transcribed since October 1968.

Unfortunately, all those pieces tend to be scattered. Even the Supreme Court's own website directs you to different pages for every one of those pieces. Other essential pieces of information, such as copies of statutes, records from the lower courts, etc, can usually be found in the briefs or elsewhere, but you have to know where to look.

So we've created this "hub" to help connect those pieces. Here's an example: an excerpt from the March 23, 2026 argument in Watson v. RNC (No. 24-1260), with links to documents that activate automatically as the argument progresses.

This website barely scratches the surface of what is possible, but hopefully it will give you sense of what a modern UI can accomplish, and maybe it will even inspire others to "follow suit."

For The Sake of Accuracy

We rely only on "authoritative" sources, starting with The U.S. Supreme Court, as well as the The National Archives, The Oyez Project, and The Supreme Court Database; however, authoritative does not mean error-free. For example:

Data from The Oyez Project is slightly more problematic, as we've noted, but being able to compare multiple data sources, including The Supreme Court Database, has been a great way of flushing out mistakes, on all sides.

And make no mistake: these are all simple, minor mistakes, so we don't mean to blow them out of proportion, but they do create problems when trying to connect all the pieces for all the cases. We make corrections here as we find them, but without the ability to feed those corrections back to their source, disconnects will persist.

For The Sake of Completeness

Missing data is also a problem; for example:

It also appears that Justia assumes one-case-per-page in their U.S. Supreme Court Opinions by Volume collection, at least in older volumes, which isn't always true. For example, Volume 6 lists only one case, "Williams & Hodgson v. Lyles", at "6 U.S. 9", but an earlier case, "Wood v. Wagnon", also appears on that page.

Advocate data is another challenge, because it's not recorded anywhere as a separate set of data. The Court does record advocate names in various places, including Transcripts, Journals, and U.S. Reports, but they presumably track that information separately as well, because on rare occasions, the Chief Justice will congratulate an attorney (e.g., Edwin Kneedler) for having just argued their 100th case.

Extracting advocate data from printed/scanned journals and transcripts is non-trivial and error-prone, and disambiguating names (ie, understanding when two similar names are different people, or vice versa) requires time. For cases from the October Term 1955 onward, we rely largely on transcripts, and for certain groups of advocates, we have either done our own research, as we did for Justice Advocates, or we have supplemented the research of others; see Women Advocates.

There is still more work to do in terms of producing a complete and accurate list of Top Advocates. Of course, if the Court shared its advocate data with the public, that would be even better.

Regarding Dates of Decisions

As we mention here, the Court published what we generally consider the "definitive" list of all (early) "Dates of Supreme Court Decisions (and Arguments)." Unfortunately, it turns out they may have missed a few.

For example, in U.S. Reports Volume 154, there is a section titled "SOME CASES NOT HITHERTO REPORTED IN FULL" which includes this preamble:

The Centennial Appendix, at the end of Volume 131, contained two tables of omitted cases. In the first table the cases were reported in full. The second contained only a list of cases, term by term [see pages ccxx to ccxxxi], in which opinions were given which were supposed to decide the case on the facts; or on the authority of some case referred to; or in which the decision was made partly on the facts and partly on such authority; or in which judgment was entered either on the stipulation of the parties, or for incompleteness of the record, or for non-compliance with the rules of court. It was assumed that it was not worth while to occupy the space necessary to report these cases in full. The fact that two or three of them have been referred to in opinions of the court, since rendered, shows that this assumption was not well founded, and calls upon the reporter now to print them in full.

So, for example, the case "1863-12/1863-084 (267): Milwaukee & Minnesota R. Co. v. Soutter", which was originally listed as No. 268 and argued on Monday, February 1, 1864, was reported in Volume 131 as No. 267, argued on February 1-9, 1864, and decided on Tuesday, February 23, 1864. However, this later report fails to mention that 68 U.S. 405 lists the case as being decided with "Bronson v. La Cross & Milwaukee R. Co.", which does appear in the "Dates of Decisions." We assume that both cases were not only decided together but also argued together, on February 1-5 and 8-9; those 7 dates also seem more plausible than 9 straight days.

While reviewing all argument dates, we have unfortunately noticed some mistakes in U.S. Reports. For example, 355 U.S. 184 reports that Green v. United States (No. 46) was reargued on October 15, 1957; however, the 1957 Journal indicates that, while No. 46 was scheduled for that day, they apparently ran out of time, because argument did not commence until the following day, on October 16, 1957.

Similarly, 445 U.S. 480 reports that Vitek v. Jones (No. 78-1155) was argued on December 3, 1979, but all other evidence (journal, audio recording, transcript) indicates it was actually argued on December 5, 1979. And 449 U.S. 200 reports that United States v. Will was argued on October 13, 1980, but the correct date is October 14, 1980; the Court was not even in session on October 13.

Curiosities

  • I'm curious about the backstory in a case from the 1943 term, Franks Bros. Co. v. NLRB (No. 521), because argument commenced on March 2, 1944 but wasn't completed until March 27, 1944.

TODO

  • The Library of Congress currently has copies of opinions from U.S. Reports as far forward as Volume 578. Unfortunately, they suffer from some sloppiness; for example, there is no entry for Sullivan v. Florida (560 U.S. 181); you can only find it at the bottom of the document for United States v. Comstock (560 U.S. 126). There are numerous other instances where opinions that should exist on loc.gov cannot be found, so at some point, a comprehensive audit should be performed.

  • Happily, the U.S. Supreme Court continues to "up its game" and now provides online copies of all U.S. Reports Volumes, so that may prove to be a better, more reliable source going forward. We will need to add a process for converting all opinion_href links to the correct page within those PDFs. Unfortunately, some of the (earlier) volumes have unusual page numbering (eg, in Volume 6, page numbers such as 12 and 15 are skipped).

  • Complete the Original Jurisdiction Archive. The Court lists 147 numbered original-jurisdiction cases (Nos. 1–147, Orig., spanning 1922–2016). The remaining cases are listed below.

No. Case Year Docs on SCOTUS page
104 New Jersey v. Nevada 1985 5
107 Michigan v. Meese 1986 3
110 Matter of Republic of Suriname ex Rel. Boerenveen 1987 3
116 Alabama v. W.R. Grace & Co. 1990 12
119 Connecticut v. New Hampshire 1991 19
123 Corrinet v. Boutros Ghali 1995 2
124 Collins v. Alabama 1996 1
125 Republic of Paraguay v. Gilmore 1998 7
131 SE Interstate Low-Level Radioactive Waste v. North Carolina 2000 5
135 Texas v. Leavitt 2006 6
136 Brzak v. United Nations 2006 1
139 Mississippi v. City of Memphis, Tenn., Memphis Light, Gas & Water Div. 2009 5
140 Louisiana v. Bryson 2011 7
144 Nebraska v. Colorado 2014 7
146 Arkansas v. Delaware 2016 34

The workflow to integrate new Original Jurisdiction Archive cases:

node scripts/import_ussc.js --orig
node scripts/download.js TERM CASE --thumbs
node scripts/update_cases.js --collections
  • There are some cases with no citation (and media files to display) and are thus currently "hidden" from view. We need to track down citations for the following.
Term Number Title Decision
1864-12 5-Orig ex parte Milwaukie and Minnesota Railroad Company 1865-02-20
1869-12 281 Hartford Fire Insurance Company v. Issac Van Duzer 1870-04-25
1872-12 (none) Barnes v. The Railroads 1873-04-28
1878-10 239 The First National Bank of The City of New York v. Abner C. Shoemaker 1878-12-16
1879-10 174 Edwin C. Litchfield v. County of Hamilton 1880-03-08
1879-10 (none) Railroad Co. v. Alabama 1880-05-10
1882-10 1151 The Union Trust Company of New York v. Edward Fitzgerald 1883-03-12
1883-10 138 Cook v. Sandusky Tool Company 1884-01-21

Command-Line Examples

Adding missing cases:

node scripts/update_cases.js 1952-10 --add "United States v. Wilson|United States v. Purchasing Corporation of America" --number 197,198 --argument 1953-01-05,1953-01-06 --decision 1953-02-02 --cite 344 U.S. 923 --votes 6-2 loss --dissent douglas burton --recused clark --appellant John F. Davis --appellee Selden S. McNeer

node scripts/update_cases.js 1952-10 --add "Ward v. United States" --number 390 --argument 1953-01-13 --decision 1953-02-02 --cite 344 U.S. 924 --votes 9-0 win --petitioner John M. Coe --petitioner Ralph E. Powe --respondent John R. Benney

Adding votes to an existing case:

node scripts/update_cases.js 2014-10 13-10400 --votes loss (eg, a per curiam opinion)

node scripts/update_cases.js 2025-10 25-112 --votes win 6-3 kagan --dissent alito barrett --minority thomas

Adding advocates to an existing case:

node scripts/update_cases.js 1938-10 771 --date 1939-04-24 --page 212 --advocate "ROBERT JACKSON|MR.,SOLICITOR GENERAL|appellant"

node scripts/update_cases.js 1938-10 771 --date 1939-04-25 --page 213 --advocate "ROBERT JACKSON|MR.,SOLICITOR GENERAL|appellant" --advocate "LEONARD ACKER|MR.|appellee" --advocate "WILLARD R. PRATT|MR.|appellee"

Applying a downloaded set of transcript edits (speaker/text corrections submitted via "Download Edits" in the transcript editor) — this patches the named turns directly in their transcript JSON files and records a changelog entry at courts/ussc/transcripts/updates:

node scripts/update_transcripts.js ussc-edits.json

MIT License

Project design (c) 2026 by Jeff Parsons

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

U.S. Supreme Court Courtroom
[Source]

Photograph of Supreme Court Building
[Source]

About

U.S. Supreme Court Arguments

Resources

Stars

5 stars

Watchers

1 watching

Forks

Sponsor this project

Contributors