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.

Harold J. Spaeth, Lee Epstein, Andrew D. Martin, Jeffrey A. Segal, Theodore J. Ruger, and Sara C. Benesh. 2016 Supreme Court Database, Version 2015 Release 02. URL: http://Supremecourtdatabase.org

Downloads

Download all of the following files.

Usage

Begin by adding the above JAR file to your classpath. This library has 1 function you can use.
import corgis.supreme_court.SupremeCourtLibrary;
import corgis.supreme_court.domain.*;
import java.util.ArrayList;

public class ExampleClass {
    public static void main(String[] args) {
        // Get access to the library
        SupremeCourtLibrary supremeCourtLibrary = new SupremeCourtLibrary();
        // Access data inside the library
        ArrayList<CourtCase> list_of_court_case = supremeCourtLibrary.getCases(false);
    }
}
Additionally, some of the functions can optionally return Big Data using the last argument (setting it to true). If you use this Big Data, it may be much slower. Wait until you are sure your code is correct before using these examples.
import corgis.supreme_court.SupremeCourtLibrary;
import corgis.supreme_court.domain.*;
import java.util.ArrayList;

public class ExampleClass {
    public static void main(String[] args) {
        // Get access to the library
        SupremeCourtLibrary supremeCourtLibrary = new SupremeCourtLibrary();
        // Access data inside the library
        ArrayList<CourtCase> list_of_court_case = supremeCourtLibrary.getCases(true);
    }
}

Documentation

We provide full JavaDoc for this library. Alternatively, you may refer to the below:

 supremeCourtLibrary.getCases(test)

Returns a list of the court cases in the database.