# CourtListener API: Search federal dockets by party > Finds federal RECAP dockets involving a named person or company, newest filed first. Only dockets in the RECAP Archive appear. Unofficial. Not affiliated with or endorsed by CourtListener. - Page: https://fous.com/methods/courtlistener.com/search-federal-dockets - Method: `courtlistener.com/search_federal_dockets`, version 1 - Website: courtlistener.com - Returns: case name, court, docket number, filed and terminated dates, status, nature of suit, cause, judge, latest docket entries, docket link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | | Page of cases, e.g. 2. Default 1. | | `court` | string | no | `"Northern District of California"` | Federal court in words, e.g. Northern District of California or Delaware bankruptcy. All federal courts if omitted. Default "". | | `party` | string | yes | `"Tesla"` | Company or person to find, e.g. Tesla. | | `filed_after` | string | no | `"2024-01-01"` | Earliest filing date, e.g. 2024-01-01. | | `max_results` | integer | no | `3` | Cases to return, e.g. 20. Default 20. | | `filed_before` | string | no | `"2024-12-31"` | Latest filing date, e.g. 2024-12-31. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "court": "Northern District of California", "party": "Tesla", "filed_after": "2024-01-01", "max_results": 3, "filed_before": "2024-12-31" } ``` Its output: ```json { "cases": [ { "cause": "28:1332 Diversity-Breach of Contract", "court": "District Court, N.D. California", "status": "open", "case_name": "Rosales v. Tesla Motors Inc.", "date_filed": "2024-12-11", "docket_link": "https://www.courtlistener.com/docket/69459066/rosales-v-tesla-motors-inc/", "docket_number": "3:24-cv-08973", "assigned_judge": "Trina L Thompson", "nature_of_suit": "Contract: Other", "date_terminated": null, "latest_docket_entries": [ { "date": "2025-03-19", "text": "Case Referred to Private ADR" }, { "date": "2025-03-19", "text": "Order Referring Case to Magistrate Judge for Discovery" }, { "date": "2025-03-19", "text": "Case Management Scheduling Order AND Order Referring Case to Private ADR AND ~Util - Set Deadlines/Hearings" } ] }, { "cause": "28:1332 Diversity-Product Liability", "court": "District Court, N.D. California", "status": "open", "case_name": "Mendoza v. Tesla, Inc.", "date_filed": "2024-12-04", "docket_link": "https://www.courtlistener.com/docket/69437572/mendoza-v-tesla-inc/", "docket_number": "3:24-cv-08738", "assigned_judge": "Vince Girdhari Chhabria", "nature_of_suit": "Personal Injury Product Liability", "date_terminated": null, "latest_docket_entries": [ { "date": "2025-05-16", "text": "ORDER Granting in Part and Denying in Part 12 Motion for Judgment on the Pleadings. Signed by Judge Vince Chhabria on 5/16/2025. (vclc1, COURT STAFF) (Filed on 5/16/2025) (Entered: 05/16/2025)" }, { "date": "2025-04-24", "text": "Minute Entry for proceedings held before Judge Vince Chhabria: Motion Hearing held via Zoom on 4/24/2025 re 12 MOTION for Judgment on the Pleadings filed by Tesla, Inc. Oral arguments made and heard. Court to issue written ruling. Total Time in Court: 11 minutes. Court Reporter: April Brott. Plainti…" }, { "date": "2025-04-23", "text": "CLERK'S NOTICE CONTINUING TIME RE 4/24//2025 MOTION HEARING, PROVIDING ZOOM ACCESS, AND REQUIRING ADVANCE REGISTRATION OF COUNSEL. 12 MOTION for Judgment on the Pleadings Hearing set for 4/24/2025 at 03:00 PM by Videoconference Only before Judge Vince Chhabria. This proceeding will be held via a Zoo…" } ] }, { "cause": "28:1332 Diversity-(Citizenship)", "court": "District Court, N.D. California", "status": "open", "case_name": "Lewis v. Tesla, Inc.", "date_filed": "2024-11-20", "docket_link": "https://www.courtlistener.com/docket/69393780/lewis-v-tesla-inc/", "docket_number": "3:24-cv-08178", "assigned_judge": "Araceli Martinez-Olguin", "nature_of_suit": "Civil Rights: Jobs", "date_terminated": null, "latest_docket_entries": [ { "date": "2024-12-31", "text": "Order Reassigning Case AND ~Util - Case Assigned/Reassigned" }, { "date": "2024-12-18", "text": "Clerk's Notice re: Consent or Declination" }, { "date": "2024-12-13", "text": "Compel" } ] } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"courtlistener.com/search_federal_dockets","input":{"court":"Northern District of California","party":"Tesla","filed_after":"2024-01-01","max_results":3,"filed_before":"2024-12-31"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find federal RECAP dockets involving Acme Logistics LLC filed after 2023-06-01 - Show me the newest federal cases where Jonathan Reyes is a party, limited to the Southern District of New York - Look up RECAP Archive dockets naming Pinnacle Biotech Inc. filed between 2022-01-01 and 2023-12-31 - Any federal bankruptcy dockets in Delaware involving Maria Okonkwo? Return 10 results. - Search courtlistener.com for federal dockets with Northstar Energy Holdings as a party, page 2 of results ## Input schema ```json { "type": "object", "required": [ "party" ], "properties": { "page": { "type": "integer", "default": 1, "maximum": 10, "minimum": 1, "description": "Page of cases, e.g. 2." }, "court": { "type": "string", "default": "", "description": "Federal court in words, e.g. Northern District of California or Delaware bankruptcy. All federal courts if omitted." }, "party": { "type": "string", "description": "Company or person to find, e.g. Tesla." }, "filed_after": { "type": "string", "description": "Earliest filing date, e.g. 2024-01-01." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Cases to return, e.g. 20." }, "filed_before": { "type": "string", "description": "Latest filing date, e.g. 2024-12-31." } } } ``` ## Output schema ```json { "type": "object", "required": [ "cases" ], "properties": { "cases": { "type": "array", "items": { "type": "object", "required": [ "case_name", "court", "docket_number", "date_filed", "date_terminated", "status", "nature_of_suit", "cause", "assigned_judge", "latest_docket_entries", "docket_link" ], "properties": { "cause": { "type": [ "string", "null" ] }, "court": { "type": [ "string", "null" ] }, "status": { "enum": [ "open", "closed" ], "type": "string" }, "case_name": { "type": [ "string", "null" ] }, "date_filed": { "type": "string", "format": "date" }, "docket_link": { "type": [ "string", "null" ] }, "docket_number": { "type": [ "string", "null" ] }, "assigned_judge": { "type": [ "string", "null" ] }, "nature_of_suit": { "type": [ "string", "null" ] }, "date_terminated": { "type": [ "string", "null" ] }, "latest_docket_entries": { "type": "array", "items": { "type": "object", "required": [ "date", "text" ], "properties": { "date": { "type": "string", "format": "date" }, "text": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false }, "description": "Federal cases found in the RECAP Archive." } }, "additionalProperties": false } ``` ## See more - [CourtListener API: Search case law](https://fous.com/methods/courtlistener.com/search-case-law.md): Searches CourtListener US court opinions by keywords or case name, with optional court, decision dates and sorting. - [CourtListener API: Get court opinion](https://fous.com/methods/courtlistener.com/get-court-opinion.md): Finds a US court opinion on CourtListener by case name, citation, or opinion link, and returns its metadata, opinions, judges, citing-case count and the lead opinion's full text from its PDF. - [The National Archives API: Search judgments](https://fous.com/methods/caselaw.nationalarchives.gov.uk/search-judgments.md): Searches UK court judgments and tribunal decisions on Find Case Law by keywords or party names. Results can be filtered by court and by judgment date. - [Oyez API: List term cases](https://fous.com/methods/oyez.org/list-term-cases.md): Lists Oyez Supreme Court cases for a term, sorted by argument date then name. Decision dates and vote splits are blank where Oyez does not provide them. - [Oyez API: Get Supreme Court case](https://fous.com/methods/oyez.org/get-supreme-court-case.md): Finds an Oyez Supreme Court case by name or case link and returns its summary, decision, justice votes and argument audio links. - [SEC EDGAR API: List company SEC filings](https://fous.com/methods/sec.gov/get-company-filings.md): Finds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date. - [SEC EDGAR API: Search filings by phrase](https://fous.com/methods/sec.gov/search-filings.md): Finds SEC EDGAR company filings that mention an exact phrase, optionally limited to a company, a filing category and a filing date range, ranked by search relevance; one entry per filing. - [Companies House API: List company filing history](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-filing-history.md): Lists a UK company's Companies House filings, newest first, with date, form code, type, description, page count and PDF link. Finds the company by name, company number or Companies House link; a category picks accounts, confirmation statements, officers, address, capital, charges or incorporation filings. - [All CourtListener methods](https://fous.com/methods/courtlistener.com.md)