CourtListener

App · Research & Academia · 10 actions

Search American law in the free archive run by the nonprofit Free Law Project. Search around ten million published court decisions, federal and state, and read any of them in full. Check every case citation in a piece of writing against the archive, which is how an invented citation is caught before it is filed. Follow federal litigation through the dockets collected out of PACER, from the case down to what was filed and when. Look up the judges who decide these cases and every seat they have held, and find recorded oral arguments with the audio. Free to use, with a free account.

Actions

ActionWhat it does
Check citationsFind every case citation in a piece of text and check each one against the archive.
Get a caseRead the full record of one decided case: its name, the day it was decided, every way it can be cited, the judges who sat on it, how often it has been cited since, and whatever the court published alongside the decision such as the syllabus, the posture and the procedural history.
Get a decisionRead the words of one decision in full: a majority opinion, a concurrence, a dissent or a per curiam order.
Get a federal caseRead the full record of one federal court case: its name and docket number, the court and the judge, when it was filed, when anything was last filed in it, whether it has been closed, what kind of suit it is, and what it was appealed from.
Get a judgeRead one judge's biography and their whole career on and off the bench: every seat and job on record, when each started and ended, who appointed them, when they were nominated and confirmed, and why a seat ended.
List filingsList what has been filed in a federal court case, newest or oldest first, with the date and the court's own description of each entry and the documents attached to it.
Search case lawSearch around ten million published decisions of American courts, federal and state, going back to the eighteenth century.
Search federal casesSearch federal court cases, the live litigation rather than the decided case law: district court, appellate and bankruptcy dockets collected out of PACER by the RECAP archive.
Search judgesSearch thousands of federal and state judges by name, by the court they have sat on, by where they studied, by who appointed them, by their political affiliation, or by how they came to the bench.
Search oral argumentsSearch recorded oral arguments from the Supreme Court and the federal appellate courts, by what was said, by the case, by its docket number, by the judges on the panel, by the court, or by when it was argued.

Check citations

Find every case citation in a piece of text and check each one against the archive. Paste in a brief, a memo, a contract or anything a language model wrote, and get back each citation it contains with a verdict: the real case it points to, or a plain statement that no such case exists. Citations with a typo in them are corrected where the correction is obvious. This is the step to put in front of anything that will be filed or sent, because an invented citation reads exactly like a real one until somebody looks it up.

Inputs

Text to checktexttextRequired
The writing to look through. It can be a single citation or a whole document of up to 64,000 characters, and up to 250 citations are checked at a time.

Outputs

all_foundtrue/false
citation_countnumber
citationslist
found_countnumber
more_citations_than_checkedtrue/false
not_foundlist
not_found_countnumber
Example output
{
  "all_found": false,
  "citation_count": 2,
  "citations": [
    {
      "case_count": 1,
      "cases": [
        {
          "case_id": 105221,
          "case_name": "Brown v. Board of Education",
          "citation": "347 U.S. 483",
          "citations": [
            "347 U.S. 483"
          ],
          "date_filed": "1954-05-17",
          "decision_ids": [
            105221
          ],
          "docket_id": 63367,
          "precedential_status": "Precedential",
          "times_cited": 3825,
          "url": "https://www.courtlistener.com/opinion/105221/brown-v-board-of-education/"
        }
      ],
      "citation": "347 U.S. 483",
      "corrected_to": [
        "347 U.S. 483"
      ],
      "ends_at": 50,
      "problem": "",
      "starts_at": 38,
      "status_code": 200,
      "verdict": "Found",
      "was_found": true
    },
    {
      "case_count": 0,
      "cases": [],
      "citation": "999 U.S. 111",
      "corrected_to": [
        "999 U.S. 111"
      ],
      "ends_at": 104,
      "problem": "",
      "starts_at": 92,
      "status_code": 404,
      "verdict": "Looks like a real citation, but CourtListener does not have the case",
      "was_found": false
    }
  ],
  "found_count": 1,
  "more_citations_than_checked": false,
  "not_found": [
    "999 U.S. 111"
  ],
  "not_found_count": 1
}

Get a case

Read the full record of one decided case: its name, the day it was decided, every way it can be cited, the judges who sat on it, how often it has been cited since, and whatever the court published alongside the decision such as the syllabus, the posture and the procedural history. It also lists the separate decisions written in the case, so the majority, a concurrence and a dissent can each be read in full with Get a decision. Takes the case ID that a case law search or a citation check returned.

Inputs

Case IDcase_idnumberRequired
The case to read, as returned by Search case law or Check citations.At least 1.

Outputs

caseobject
Example output
{
  "case": {
    "attorneys": "Thurgood Marshall for appellants",
    "case_id": 105221,
    "case_name": "Brown v. Board of Education",
    "case_name_full": "Brown v. Board of Education of Topeka",
    "case_name_short": "Brown",
    "citation": "347 U.S. 483",
    "citations": [
      "347 U.S. 483",
      "74 S. Ct. 686"
    ],
    "date_filed": "1954-05-17",
    "date_is_approximate": false,
    "decision_ids": [
      105221
    ],
    "disposition": "",
    "docket_id": 63367,
    "headnotes": "",
    "judge_ids": [
      3182
    ],
    "judges": "Warren",
    "nature_of_suit": "",
    "non_participating_judge_ids": [],
    "posture": "",
    "precedential_status": "Precedential",
    "precedential_status_code": "Published",
    "procedural_history": "",
    "summary": "",
    "syllabus": "Segregation of children in public schools solely on the basis of race deprives children of the minority group of equal educational opportunities.",
    "times_cited": 3825,
    "url": "https://www.courtlistener.com/opinion/105221/brown-v-board-of-education/"
  }
}

Get a decision

Read the words of one decision in full: a majority opinion, a concurrence, a dissent or a per curiam order. The answer says which kind it is, who wrote it, which judges joined it, and which other decisions it cites, and carries the text itself with the markup taken off, ready to summarise, quote or search in a later step. Takes the decision ID that a case law search or Get a case returned.

Inputs

Decision IDdecision_idnumberRequired
The decision to read, as returned by Search case law or Get a case.At least 1.

Outputs

decisionobject
Example output
{
  "decision": {
    "case_id": 105221,
    "cited_decision_ids": [
      96528,
      99967
    ],
    "decision_id": 105221,
    "is_per_curiam": false,
    "joined_by_judge_ids": [],
    "kind": "Combined opinion",
    "kind_code": "combined-opinion",
    "page_count": 11,
    "source_copy": "html_with_citations",
    "source_file_url": "",
    "text": "We come then to the question presented: Does segregation of children in public schools solely on the basis of race, even though the physical facilities and other tangible factors may be equal, deprive the children of the minority group of equal educational opportunities? We believe that it does.",
    "text_length": 297,
    "url": "https://www.courtlistener.com/opinion/105221/brown-v-board-of-education/",
    "was_scanned": false,
    "written_by_judge_id": 3182
  }
}

Get a federal case

Read the full record of one federal court case: its name and docket number, the court and the judge, when it was filed, when anything was last filed in it, whether it has been closed, what kind of suit it is, and what it was appealed from. It also points at the decisions published in the case and any recorded oral arguments, so the litigation and the case law it produced join up. Takes the case ID that a federal case search returned.

Inputs

Case IDcase_idnumberRequired
The federal case to read, as returned by Search federal cases.At least 1.

Outputs

caseobject
Example output
{
  "case": {
    "appealed_from": "",
    "assigned_judge": "Amit P. Mehta",
    "assigned_judge_id": 1124,
    "case_id": 65745614,
    "case_law_ids": [],
    "case_name": "United States v. Example Corp",
    "case_name_full": "United States of America v. Example Corporation",
    "cause": "15:1 Antitrust Litigation",
    "court": "District of Columbia District Court",
    "court_id": "dcd",
    "date_argued": "",
    "date_filed": "2024-04-30",
    "date_last_filing": "2025-02-11",
    "date_terminated": "",
    "docket_number": "1:24-cv-01234",
    "is_closed": false,
    "jurisdiction_type": "U.S. Government Plaintiff",
    "jury_demand": "None",
    "nature_of_suit": "410 Antitrust",
    "oral_argument_ids": [],
    "referred_judge": "",
    "url": "https://www.courtlistener.com/docket/65745614/united-states-v-example-corp/"
  }
}

Get a judge

Read one judge's biography and their whole career on and off the bench: every seat and job on record, when each started and ended, who appointed them, when they were nominated and confirmed, and why a seat ended. Takes the judge ID that a judge search returned, or the one carried on a decision as its author.

Inputs

Judge IDjudge_idnumberRequired
The judge to read, as returned by Search judges or carried on a decision as the judge who wrote it.At least 1.

Outputs

judgeobject
Example output
{
  "judge": {
    "born_in": "Bronx, NY",
    "date_of_birth": "1954-01-01",
    "date_of_death": "",
    "gender": "f",
    "has_photo": true,
    "judge_id": 3045,
    "name": "Sonia Sotomayor",
    "name_first": "Sonia",
    "name_last": "Sotomayor",
    "name_middle": "",
    "position_count": 1,
    "positions": [
      {
        "appointed_by": "Barack Obama",
        "court": "Supreme Court of the United States",
        "court_id": "scotus",
        "date_confirmed": "2009-08-06",
        "date_nominated": "2009-06-01",
        "ended": "",
        "how_selected": "Appointed by the President",
        "is_current": true,
        "organization": "",
        "role": "Associate Justice",
        "started": "2009-08-08",
        "why_it_ended": ""
      }
    ],
    "religion": "",
    "suffix": "",
    "url": "https://www.courtlistener.com/person/3045/sonia-sotomayor/"
  }
}

List filings

List what has been filed in a federal court case, newest or oldest first, with the date and the court's own description of each entry and the documents attached to it. Narrow it to a range of dates to see only what has happened lately, which is how a workflow watches a case it cares about. Each document says how many pages it runs to and whether the archive holds the document itself, and its text can be included when a later step needs to read it.

Inputs

Case IDcase_idnumberRequired
The federal case whose filings to list, as returned by Search federal cases.At least 1.
Filed on or afterfiled_afterdate
Only filings made on or after this day.
Filed on or beforefiled_beforedate
Only filings made on or before this day.
Sort bysort_bytext
The order to read the filings in.One of: newest (Newest first), oldest (Oldest first).
Include the text of each documentinclude_document_texttrue/false
Bring back the words of every document as well as its description. Leave this off unless a later step reads them: a busy docket runs to hundreds of pages.Default: false.
Pagepagenumber
Which page of filings to read. Twenty come back at a time, newest or oldest first as chosen above.From 1 to 100. Default: 1.

Outputs

case_idnumber
filingslist
has_moretrue/false
pagenumber
result_countnumber
total_filingsnumber
Example output
{
  "case_id": 65745614,
  "filings": [
    {
      "date_filed": "2024-04-30",
      "description": "COMPLAINT against Example Corporation, filed by United States of America.",
      "document_count": 1,
      "documents": [
        {
          "attachment_number": null,
          "can_be_read": true,
          "description": "Main Document",
          "document_id": 301948221,
          "document_number": 1,
          "page_count": 42,
          "source_file_url": "",
          "url": "https://www.courtlistener.com/docket/65745614/1/united-states-v-example-corp/",
          "was_scanned": false
        }
      ],
      "entry_number": 1,
      "filing_id": 240118837
    }
  ],
  "has_more": false,
  "page": 1,
  "result_count": 1,
  "total_filings": 1
}

Search case law

Search around ten million published decisions of American courts, federal and state, going back to the eighteenth century. Search by words in the decisions, by the name of the case, by a citation, by the judge who wrote it, by the court it came from, or by when it was decided, and combine any of those. Each result carries the case, how to cite it, how often it has since been cited, and the separate opinions written in it, so a dissent can be read on its own. The twenty best matches come back, along with how many there are in all.

Inputs

Search wordsquerytext
Words to look for in the decisions themselves. Quotation marks keep a phrase together, and AND, OR and NOT work as you would expect.
Case namecase_nametext
Part of the name of the case, when you know roughly what it is called.
Citationcitationtext
A citation, when you have one and want the case it refers to.
Judgejudgetext
The judge who wrote the decision. A surname is usually enough.
Courtcourttext
Which court to look in. Leave it empty to search every court at once.One of: scotus (Supreme Court of the United States), ca1 (Court of Appeals for the First Circuit), ca2 (Court of Appeals for the Second Circuit), ca3 (Court of Appeals for the Third Circuit), ca4 (Court of Appeals for the Fourth Circuit), ca5 (Court of Appeals for the Fifth Circuit), ca6 (Court of Appeals for the Sixth Circuit), ca7 (Court of Appeals for the Seventh Circuit), ca8 (Court of Appeals for the Eighth Circuit), ca9 (Court of Appeals for the Ninth Circuit), and 462 more.
Decided on or afterfiled_afterdate
Only decisions handed down on or after this day.
Decided on or beforefiled_beforedate
Only decisions handed down on or before this day.
Kind of decisionprecedential_statustext
Which decisions count. Precedential decisions are the ones that bind later courts, and are all that is searched when nothing is chosen here.One or more of: Published (Precedential), Unpublished (Non-Precedential), Errata, Separate (Separate opinion), In-chambers (In chambers), Relating-to (Relating-to orders), Unknown.
Cited more thancited_more_thannumber
Only decisions later courts have cited more than this many times. A good way to find the leading cases on a question rather than every case that mentions it.From 0 to 100000.
Sort bysort_bytext
The order to read the results in.One of: best_match (Best match), newest (Newest first), oldest (Oldest first), most_cited (Most cited first), least_cited (Least cited first).

Outputs

caseslist
more_matches_than_showntrue/false
result_countnumber
total_matchesnumber
Example output
{
  "cases": [
    {
      "case_id": 105221,
      "case_name": "Brown v. Board of Education",
      "case_name_full": "Brown v. Board of Education of Topeka",
      "citation": "347 U.S. 483",
      "citations": [
        "347 U.S. 483",
        "74 S. Ct. 686",
        "98 L. Ed. 873"
      ],
      "court": "Supreme Court of the United States",
      "court_id": "scotus",
      "date_argued": "1952-12-09",
      "date_filed": "1954-05-17",
      "decisions": [
        {
          "decision_id": 105221,
          "excerpt": "We conclude that in the field of public education the doctrine of separate but equal has no place.",
          "is_per_curiam": false,
          "kind": "Combined opinion",
          "kind_code": "combined-opinion",
          "source_file_url": "",
          "written_by_judge_id": 3182
        }
      ],
      "docket_id": 63367,
      "docket_number": "1",
      "judges": "Warren",
      "precedential_status": "Precedential",
      "precedential_status_code": "Published",
      "times_cited": 3825,
      "url": "https://www.courtlistener.com/opinion/105221/brown-v-board-of-education/"
    }
  ],
  "more_matches_than_shown": false,
  "result_count": 1,
  "total_matches": 1
}

Search federal cases

Search federal court cases, the live litigation rather than the decided case law: district court, appellate and bankruptcy dockets collected out of PACER by the RECAP archive. Search by words in the documents filed, by the name of the case, by its docket number, by a party or a law firm, by the judge it is assigned to, by what kind of suit it is, or by when it was filed. Each result carries the case, the judge, the parties, and the filings that matched. The twenty best matches come back, along with how many there are in all.

Inputs

Search wordsquerytext
Words to look for in the documents filed in the case. Quotation marks keep a phrase together.
Case namecase_nametext
Part of the name of the case.
Docket numberdocket_numbertext
The court's own number for the case, when you have it.
Courtcourttext
Which federal court to look in. Leave it empty to search every federal court at once. Only federal courts appear here, because state cases are not filed through the federal system.One of: ca1 (Court of Appeals for the First Circuit), ca2 (Court of Appeals for the Second Circuit), ca3 (Court of Appeals for the Third Circuit), ca4 (Court of Appeals for the Fourth Circuit), ca5 (Court of Appeals for the Fifth Circuit), ca6 (Court of Appeals for the Sixth Circuit), ca7 (Court of Appeals for the Seventh Circuit), ca8 (Court of Appeals for the Eighth Circuit), ca9 (Court of Appeals for the Ninth Circuit), ca10 (Court of Appeals for the Tenth Circuit), and 194 more.
Partyparty_nametext
A person or company involved in the case, on either side.
Attorneyattorney_nametext
An attorney who has appeared in the case.
Judgejudgetext
The judge the case is assigned to.
Nature of suitnature_of_suittext
What kind of case it is, in the words the federal courts use on the cover sheet.
Filed on or afterfiled_afterdate
Only cases opened on or after this day.
Filed on or beforefiled_beforedate
Only cases opened on or before this day.
Only cases with readable documentsavailable_onlytrue/false
Leave out cases where the archive has the docket but none of the documents themselves. Turn this on when the next step needs to read what was filed.Default: false.
Sort bysort_bytext
The order to read the results in.One of: best_match (Best match), newest_case (Newest case first), oldest_case (Oldest case first), newest_filing (Newest filing first), oldest_filing (Oldest filing first).

Outputs

caseslist
more_matches_than_showntrue/false
result_countnumber
total_matchesnumber
Example output
{
  "cases": [
    {
      "assigned_judge": "Amit P. Mehta",
      "assigned_judge_id": 1124,
      "attorneys": [
        "Jane Q. Attorney"
      ],
      "case_id": 65745614,
      "case_name": "United States v. Example Corp",
      "case_name_full": "United States of America v. Example Corporation",
      "cause": "15:1 Antitrust Litigation",
      "court": "District of Columbia District Court",
      "court_id": "dcd",
      "date_argued": "",
      "date_filed": "2024-04-30",
      "date_terminated": "",
      "docket_number": "1:24-cv-01234",
      "jury_demand": "None",
      "matching_filings": [
        {
          "attachment_number": null,
          "can_be_read": true,
          "date_filed": "2024-04-30",
          "description": "COMPLAINT against Example Corporation.",
          "document_id": 301948221,
          "document_number": 1,
          "entry_number": 1,
          "excerpt": "Plaintiff United States of America brings this civil action.",
          "filing_id": 240118837,
          "page_count": 42,
          "url": "https://www.courtlistener.com/docket/65745614/1/united-states-v-example-corp/"
        }
      ],
      "nature_of_suit": "410 Antitrust",
      "parties": [
        "United States of America",
        "Example Corporation"
      ],
      "referred_judge": "",
      "url": "https://www.courtlistener.com/docket/65745614/united-states-v-example-corp/"
    }
  ],
  "more_matches_than_shown": false,
  "result_count": 1,
  "total_matches": 1
}

Search judges

Search thousands of federal and state judges by name, by the court they have sat on, by where they studied, by who appointed them, by their political affiliation, or by how they came to the bench. Each result carries their dates, their schools, any American Bar Association rating, and every seat they have held with the dates. Use it to find out who will hear a matter before it is heard. The twenty best matches come back, along with how many there are in all.

Inputs

Namenametext
All or part of the judge's name.
Courtcourttext
Which court to look in. Leave it empty to search every court at once.One of: scotus (Supreme Court of the United States), ca1 (Court of Appeals for the First Circuit), ca2 (Court of Appeals for the Second Circuit), ca3 (Court of Appeals for the Third Circuit), ca4 (Court of Appeals for the Fourth Circuit), ca5 (Court of Appeals for the Fifth Circuit), ca6 (Court of Appeals for the Sixth Circuit), ca7 (Court of Appeals for the Seventh Circuit), ca8 (Court of Appeals for the Eighth Circuit), ca9 (Court of Appeals for the Ninth Circuit), and 462 more.
Schoolschooltext
A school or law school the judge attended.
Appointed byappointed_bytext
The president or governor who appointed them, by name.
Political affiliationpolitical_affiliationtext
The party a judge has been affiliated with, where CourtListener has a record of one.One of: d (Democratic), r (Republican), i (Independent), g (Green), l (Libertarian), f (Federalist), w (Whig), j (Jeffersonian Republican), u (National Union), z (Reform Party).
How they reached the benchselection_methodtext
Whether the judge was elected or appointed, and by whom.One of: e_part (Partisan election), e_non_part (Non-partisan election), a_pres (Appointed by the President), a_gov (Appointed by a Governor), a_legis (Appointed by a legislature), a_judge (Appointed by a judge), ct_trans (Transferred in a court restructuring).
Sort bysort_bytext
The order to read the results in.One of: best_match (Best match), name, youngest (Most recently born), oldest (Least recently born).

Outputs

judgeslist
more_matches_than_showntrue/false
result_countnumber
total_matchesnumber
Example output
{
  "judges": [
    {
      "aba_ratings": [
        "Well Qualified"
      ],
      "born_in": "Bronx, NY",
      "date_of_birth": "1954-01-01",
      "date_of_death": "",
      "judge_id": 3045,
      "name": "Sonia Sotomayor",
      "political_affiliations": [
        "Democratic"
      ],
      "positions": [
        {
          "appointed_by": "Barack Obama",
          "court": "Supreme Court of the United States",
          "court_id": "scotus",
          "date_confirmed": "2009-08-06",
          "date_nominated": "2009-06-01",
          "ended": "",
          "how_selected": "Appointed by the President",
          "is_current": true,
          "organization": "",
          "role": "Associate Justice",
          "started": "2009-08-08",
          "why_it_ended": ""
        }
      ],
      "schools": [
        "Princeton University",
        "Yale University"
      ],
      "url": "https://www.courtlistener.com/person/3045/sonia-sotomayor/"
    }
  ],
  "more_matches_than_shown": false,
  "result_count": 1,
  "total_matches": 1
}

Search oral arguments

Search recorded oral arguments from the Supreme Court and the federal appellate courts, by what was said, by the case, by its docket number, by the judges on the panel, by the court, or by when it was argued. Each result carries the date, how long the argument ran, and a link to the recording itself, so a later step can transcribe it or hand it to somebody to listen to. The twenty best matches come back, along with how many there are in all.

Inputs

Search wordsquerytext
Words to look for in what was said. Quotation marks keep a phrase together.
Case namecase_nametext
Part of the name of the case.
Docket numberdocket_numbertext
The court's own number for the case.
Judgejudgetext
A judge on the panel that heard the argument.
Courtcourttext
Which court to look in. Leave it empty to search every court at once.One of: scotus (Supreme Court of the United States), ca1 (Court of Appeals for the First Circuit), ca2 (Court of Appeals for the Second Circuit), ca3 (Court of Appeals for the Third Circuit), ca4 (Court of Appeals for the Fourth Circuit), ca5 (Court of Appeals for the Fifth Circuit), ca6 (Court of Appeals for the Sixth Circuit), ca7 (Court of Appeals for the Seventh Circuit), ca8 (Court of Appeals for the Eighth Circuit), ca9 (Court of Appeals for the Ninth Circuit), and 462 more.
Argued on or afterargued_afterdate
Only arguments heard on or after this day.
Argued on or beforeargued_beforedate
Only arguments heard on or before this day.
Sort bysort_bytext
The order to read the results in.One of: best_match (Best match), newest (Newest first), oldest (Oldest first).

Outputs

argumentslist
more_matches_than_showntrue/false
result_countnumber
total_matchesnumber
Example output
{
  "arguments": [
    {
      "argument_id": 74221,
      "audio_url": "https://www.supremecourt.gov/media/audio/mp3files/22-451.mp3",
      "case_name": "Loper Bright Enterprises v. Raimondo",
      "case_name_full": "Loper Bright Enterprises, et al. v. Gina Raimondo, Secretary of Commerce",
      "court": "Supreme Court of the United States",
      "court_id": "scotus",
      "date_argued": "2024-01-17",
      "docket_id": 67684143,
      "docket_number": "22-451",
      "excerpt": "We granted certiorari to consider whether Chevron should be overruled.",
      "judges": "",
      "length_minutes": 217,
      "url": "https://www.courtlistener.com/audio/74221/loper-bright-enterprises-v-raimondo/"
    }
  ],
  "more_matches_than_shown": false,
  "result_count": 1,
  "total_matches": 1
}

On this page