String docs
Site integrations

CourtListener

CourtListener, Free Law Project's open archive of US case law: search court opinions, federal dockets from PACER (RECAP) and oral-argument recordings by party name or any words, with case name, court, dates, docket number, citations, parties, attorneys, judge, nature of suit and matching text.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: courtlistener
  • Version: 1.0.0
  • Reads from: courtlistener.com
ActionDescriptionListed price
searchSearch CourtListener's US case law by party name or any words: court opinions, federal dockets from PACER (RECAP) or oral-argument recordings. Each row is one case with its name, court, year, docket number and dates; opinions add precedential status and citations, dockets add parties, attorneys, judge, nature of suit and the matching docket entries, oral arguments add the panel and length; every row has the matching text.Billed per request at your plan's rates

Search CourtListener's US case law by party name or any words: court opinions, federal dockets from PACER (RECAP) or oral-argument recordings. Each row is one case with its name, court, year, docket number and dates; opinions add precedential status and citations, dockets add parties, attorneys, judge, nature of suit and the matching docket entries, oral arguments add the panel and length; every row has the matching text.

POST https://request.usestring.ai/v1/integrations/courtlistener/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. Words or a quoted phrase, such as "Jane Doe". Searches case names, parties and the full text. At least 2 characters. At most 500 characters.
typeo r oao for opinions (the default), r for federal dockets from PACER (RECAP), oa for oral-argument recordings.
orderrelevance newest oldestrelevance (the default), newest or oldest.
pagesintegerHow many pages to read, from 1: 20 opinions or oral arguments, or 10 dockets, a page. From 1 to 5.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
typestringo, r or oa, as searched.
caseNamestring—
urlstring—
courtstring | nullThe court's citation abbreviation, such as 7th Cir. or Ill. App. Ct.
yearinteger | null—
docketNumberstring | null—
dateFiledstring | nullYYYY-MM-DD.
dateTerminatedstring | nullYYYY-MM-DD, dockets only.
dateArguedstring | nullYYYY-MM-DD, oral arguments only.
statusstring | nullPrecedential status, such as Published or Unpublished, opinions only.
citationsstring | nullReporter citations, opinions only.
natureOfSuitstring | null—
causestring | null—
juryDemandstring | null—
assignedTostring | nullThe judge the docket is assigned to.
referredTostring | null—
judgestring | nullThe panel, oral arguments only.
durationstring | nullThe recording's length, oral arguments only.
partiesstring | nullEvery party, as one comma-separated list, dockets only.
attorneysstring | nullEvery attorney, as one comma-separated list, dockets only.
snippetstring | nullThe matching text.
documentsobject[]The docket entries that matched, dockets only.
documents[].titlestringSuch as Document #1208723646.
documents[].urlstring—
documents[].pagesinteger | null—
documents[].dateFiledstring | null—
documents[].descriptionstring | nullThe docket entry's text.
documents[].snippetstring | nullThe matching text inside the document.

Example

curl https://request.usestring.ai/v1/integrations/courtlistener/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "\"Elon Musk\"",
    "type": "r"
  }'

data starts with these rows:

[
  {
    "type": "r",
    "caseName": "In re: Elon Musk",
    "url": "https://www.courtlistener.com/docket/69755346/in-re-elon-musk/",
    "court": "D.C. Cir.",
    "year": 2025,
    "docketNumber": "25-5072",
    "dateFiled": "2025-03-18",
    "dateTerminated": "2025-07-11",
    "dateArgued": null,
    "status": null,
    "citations": null,
    "natureOfSuit": null,
    "cause": null,
    "juryDemand": null,
    "assignedTo": null,
    "referredTo": null,
    "judge": null,
    "duration": null,
    "parties": "U.S. DOGE Service, U.S. DOGE Service Temporary Organization, In re: Elon Musk, in his official capacity, Donald J. Trump, in his official capacity as President of the United States",
    "attorneys": "Joshua Bendor, Katherine Connolly Sadeck, Esquire, Nicholas Reiss Green, Heidi Parry Stern, Solicitor, Maria Florence Buxton, Mark Reiling Freeman, Attorney, Eric Dean McArthur, Esquire, Attorney, Joshua Dos Santos, Attorney, Emma Grunberg, Gerard J. Cedrone, Esquire, David Dana Day, Ryan P. Kane, Adam Kirschner, Elizabeth C. Kramer, Astrid Carrete, Jason Evans, Timothy Holzman, Carolyn Downs, Brian Simmonds Marshall",
    "snippet": null,
    "documents": [
      {
        "title": "Document #1208723646",
        "url": "https://www.courtlistener.com/docket/69755346/01208723646/in-re-elon-musk/",
        "pages": 36,
        "dateFiled": "2025-03-25",
        "description": "REPLY [2107675] filed by Elon Musk, Donald J. Trump, U.S. DOGE Service and U.S. DOGE Temporary Service Organization to response [2107454-2] [Service Date: 03/25/2025 by Email, CM/ECF NDA] Length Certification: 3861. [25-5072] (Dos Santos, Joshua) [Entered: 03/25/2025 04:14 PM]",
        "snippet": "…FOR THE DISTRICT OF COLUMBIA CIRCUIT In re ELON MUSK, in his official capacity, et al., …"
      }
    ]
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.