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
| Action | What it does |
|---|---|
| Check citations | Find every case citation in a piece of text and check each one against the archive. |
| 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. |
| Get a decision | Read the words of one decision in full: a majority opinion, a concurrence, a dissent or a per curiam order. |
| 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. |
| 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. |
| 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. |
| Search case law | Search around ten million published decisions of American courts, federal and state, going back to the eighteenth century. |
| 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 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. |
| 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. |
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 check
texttextRequired - 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/falsecitation_countnumbercitationslistfound_countnumbermore_citations_than_checkedtrue/falsenot_foundlistnot_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 ID
case_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 ID
decision_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 ID
case_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 ID
judge_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 ID
case_idnumberRequired - The federal case whose filings to list, as returned by Search federal cases.At least 1.
- Filed on or after
filed_afterdate - Only filings made on or after this day.
- Filed on or before
filed_beforedate - Only filings made on or before this day.
- Sort by
sort_bytext - The order to read the filings in.One of:
newest(Newest first),oldest(Oldest first). - Include the text of each document
include_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. - Page
pagenumber - 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_idnumberfilingslisthas_moretrue/falsepagenumberresult_countnumbertotal_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 words
querytext - 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 name
case_nametext - Part of the name of the case, when you know roughly what it is called.
- Citation
citationtext - A citation, when you have one and want the case it refers to.
- Judge
judgetext - The judge who wrote the decision. A surname is usually enough.
- Court
courttext - 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 after
filed_afterdate - Only decisions handed down on or after this day.
- Decided on or before
filed_beforedate - Only decisions handed down on or before this day.
- Kind of decision
precedential_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 than
cited_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 by
sort_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
caseslistmore_matches_than_showntrue/falseresult_countnumbertotal_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 words
querytext - Words to look for in the documents filed in the case. Quotation marks keep a phrase together.
- Case name
case_nametext - Part of the name of the case.
- Docket number
docket_numbertext - The court's own number for the case, when you have it.
- Court
courttext - 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. - Party
party_nametext - A person or company involved in the case, on either side.
- Attorney
attorney_nametext - An attorney who has appeared in the case.
- Judge
judgetext - The judge the case is assigned to.
- Nature of suit
nature_of_suittext - What kind of case it is, in the words the federal courts use on the cover sheet.
- Filed on or after
filed_afterdate - Only cases opened on or after this day.
- Filed on or before
filed_beforedate - Only cases opened on or before this day.
- Only cases with readable documents
available_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 by
sort_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
caseslistmore_matches_than_showntrue/falseresult_countnumbertotal_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
- Name
nametext - All or part of the judge's name.
- Court
courttext - 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. - School
schooltext - A school or law school the judge attended.
- Appointed by
appointed_bytext - The president or governor who appointed them, by name.
- Political affiliation
political_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 bench
selection_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 by
sort_bytext - The order to read the results in.One of:
best_match(Best match),name,youngest(Most recently born),oldest(Least recently born).
Outputs
judgeslistmore_matches_than_showntrue/falseresult_countnumbertotal_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 words
querytext - Words to look for in what was said. Quotation marks keep a phrase together.
- Case name
case_nametext - Part of the name of the case.
- Docket number
docket_numbertext - The court's own number for the case.
- Judge
judgetext - A judge on the panel that heard the argument.
- Court
courttext - 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 after
argued_afterdate - Only arguments heard on or after this day.
- Argued on or before
argued_beforedate - Only arguments heard on or before this day.
- Sort by
sort_bytext - The order to read the results in.One of:
best_match(Best match),newest(Newest first),oldest(Oldest first).
Outputs
argumentslistmore_matches_than_showntrue/falseresult_countnumbertotal_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
}