supreme court icon

Supreme Court Python Library

From the CORGIS Dataset Project

By Austin Cory Bart acbart@vt.edu, Joung Min Choi joungmin@vt.edu, Bo Guan jasonguan0107@vt.edu
Version 3.0.0, created 10/5/2021
Tags: us, usa, united states, government, law, legal, court, case, supreme, judge, barrister, lawyer, federal, national

Overview

The U.S. Supreme Court Database traces its history back about two decades ago, when Harold J. Spaeth asked the National Science Foundation to fund a database that would be so rich in content that multiple users - even those with vastly distinct projects and purposes in mind - could draw on it. Professor Spaeth's goal was at once refreshingly simple and extremely ambitious: to produce a database that would include and classify every single vote by a Supreme Court justice in all argued cases over a five-decade period. After securing the funding, Spaeth collected and coded the data, performed reliability checks, and eventually amassed the Database. In the late 1980s, he made it (and the documentation necessary to use it) publicly available.

Since then, Professor Spaeth has not only updated it each term; he has also continued to perform reliability analyses, thereby ensuring its integrity with each release, and added new variables. Today's version of the Database houses 247 pieces of information for each case, roughly broken down into six categories: (1) identification variables (e.g., citations and docket numbers); (2) background variables (e.g., how the Court took jurisdiction, origin and source of the case, the reason the Court agreed to decide it); (3) chronological variables (e.g., the date of decision, term of Court, natural court); (4) substantive variables (e.g., legal provisions, issues, direction of decision); (5) outcome variables (e.g., disposition of the case, winning party, formal alteration of precedent, declaration of unconstitutionality); and (6) voting and opinion variables (e.g., how the individual justices voted, their opinions and interagreements).

Case Centered data provides case level information; i.e., each row in the database corresponds to a dispute. These data do not contain specific justice vote information.

A tremendously helpful resource for learning more about the dataset is the codebook: http://supremecourtdatabase.org/documentation.php?s=1.

http://supremecourtdatabase.org/data.php

Explore Structure

Each row represents court case.

Index Type Example Value
0 dict { }
1 dict (same structure)
2 dict (same structure)
... ... ...
Key Type Example Value Description
"3_judge_dc" bool True whether the case was heard by a three-judge federal district court (occasionally called ��as specially constituted district court��)
"docket" int 24 the docket number that the Supreme Court has assigned to the case
"name" str "HALLIBURTON OIL WELL CEMENTING CO. v. WALKER et al., DOING BUSINESS AS DEPTHOGRAPH CO." the name of the case
"citation" dict { }
"decision" dict { }
"id" dict { }
"issue" dict { }
"laws" dict { }
"lower court" dict { }
"natural court" dict { }
"origin" dict { }
"source" dict { }
"voting" dict { }
"arguments" dict { }
Key Type Example Value Description
"led" str "91 L. Ed. 3" the citation to each case from the United States Reports(LEd)
"lexis" str "1946 U.S. LEXIS 1724" the citation to each case from the LEXIS cite
"sct" str "67 S. Ct. 6" the citation to each case from the Supreme Court Reporter (S.CT)
"us" str "329 U.S. 1" the citation to each case from the official United States Reports (US)
Key Type Example Value Description
"authority" str "4.0" the bases on which the Supreme Court rested its decision with regard to each legal provision that the Court considered in the case
"direction" str "liberal" the ideological "direction" of the decision to determine whether the Court supports or opposes the issue to which the case pertains
"dissent agrees" bool True whether the dissenting opinion and the majority in a case both support (1) or, conversely, oppose (0) the issue to which the case pertains
"jurisdiction" str "rehearing or restored to calendar for reargument" a variety of means whereby the Court undertakes to consider cases that it has been petitioned to review
"precedent altered?" bool True whether the majority opinion effectively says that the decision in this case "overruled" one or more of the Court's own precedents
"term" int 1946 the term in which the Court handed down its decision
"type" str "opinion of the court (orally argued)" the decision type the Court made for the case
"unconstitutional" str "no declaration of unconstitutionality" whether the Court either declared unconstitutional an act of Congress; a state or territorial statute, regulation, or constitutional provision; or a municipal or other local ordinance
"winning party" str "petitioning party received a favorable disposition" whether the petitioning party (i.e., the plaintiff or the appellant) emerged victorious
"admin action" dict { }
"case" dict { }
"date" dict { }
Key Type Example Value Description
"case" str "1946-001" the first of four unique internal identification numbers
"case issues" str "1946-001-01-01" the third of four unique internal identification numbers
"docket" str "1946-001-01" the second of four unique internal identification numbers
"vote" str "1946-001-01-01-01" the fourth of four unique internal identification numbers
Key Type Example Value Description
"area" str "Economic Activity" This variable simply separates the issues identified in the preceding variable (issue) into the larger categories
"id" int 80180 issue id
"text" str "patents and copyrights: patent" the issue for each decision
Key Type Example Value Description
"id" int 6 id for the law type
"type" str "Infrequently litigated statutes" the constitutional provision(s), statute(s), or court rule(s) that the Court considered in the case
Key Type Example Value Description
"direction" str "conservative" whether the decision of the court whose decision the Supreme Court reviewed was itself liberal or conservative as these terms are defined in the direction of decision variable
"disagreement?" bool True the Supreme Court's majority opinion mentioned that one or more of the members of the court whose decision the Supreme Court reviewed dissented
"disposition" str "affirmed" the treatment the court whose decision the Supreme Court reviewed accorded the decision of the court it reviewed
"reasons" str "to resolve question presented" the reason, if any, that the Court gives for granting the petition for certiorari
Key Type Example Value Description
"chief" str "Vinson" the chief justice during whose tenure the case was decided
"id" int 1301 natural court id
"period" int 1 a period during which no personnel change occurs
Key Type Example Value Description
"id" int 51 origin id
"name" str "California Southern U.S. District Court" the court in which the case originated, not the administrative agency
Key Type Example Value Description
"id" int 29 source id
"name" str "U.S. Court of Appeals Ninth Circuit" the court whose decision the Supreme Court reviewed
Key Type Example Value Description
"majority" int 8 the frequency with which given justices vote with the majority
"minority" int 1 the number of votes in dissent
"split on second" bool True whether the vote variables (e.g., majVotes, minVotes) pertain to the vote on the second issue
"unclear" bool True whether the vote was not clearly specified
"majority assigner" dict { }
"majority writer" dict { }
Key Type Example Value Description
"petitioner" dict { }
"respondent" dict { }
Key Type Example Value Description
"entity" str "oil company / or natural gas producer" the party who petitioned the Supreme Court to review the case
"id" int 198 petitioner id
Key Type Example Value Description
"entity" str "inventor / patent assigner / trademark owner or holder" the party being sued or tried and is also known as the appellee
"id" int 172 respondent id
Key Type Example Value Description
"agency" str "Unidentifiable 
" administrative agency activity occurring prior to the onset of litigation
"id" int 118 id for the administrative agency activity occurring prior to the onset of litigation
Key Type Example Value Description
"disposition" str "reversed" the treatment the Supreme Court accorded the court whose decision it reviewed
"unusual" bool True whether the Court made an unusual disposition of the cited case which does not match the coding scheme of the preceding variable
Key Type Example Value Description
"day" int 18 the day that the Court announced its decision in the case
"full" str "11/18/1946" the year, month, and day that the Court announced its decision in the case
"month" int 11 the month that the Court announced its decision in the case
"year" int 1946 the year that the Court announced its decision in the case
Key Type Example Value Description
"id" int 78 id for the majority opinion assigner
"name" str "HLBlack" the assigner of the opinion or judgment of the Court
Key Type Example Value Description
"id" int 78 id for the majority opinion writer
"name" str "HLBlack" the author of the Court's opinion or judgment,

Downloads

Download all of the following files.

  1. supreme_court.py
  2. supreme_court.data

Usage

import supreme_court
court_case = supreme_court.get_court_case()

Documentation

get_court_case()
Returns a list of dictionaries representing court case.