Faro
Tools/case-law
Case Law

Case Law

Active

Your agent hallucinates case citations; this returns real US court opinions and dockets from CourtListener.

4 tools

US court opinions and dockets: search case law and oral arguments, and look up opinions, opinion clusters, and dockets by ID. Sourced from CourtListener (Free Law Project); opinions are public-domain or openly licensed.

Knowledge & Referencecase-lawlegalcourt-opinionsdocketsjurisprudence

Tools (4)

▶search

Search US case law, dockets, and oral arguments by keyword and filters.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Search Supreme Court opinions about free speech”
  • “Find case law on patent infringement filed after 2020-01-01”
  • “Search for opinions from the Seventh Circuit mentioning antitrust”

Parameters

qstringrequired

Search query text.

typestringoptionaldefault: "o"

Result type (o=opinions, r=dockets, rd=filing docs, d=PACER dockets, p=judges, oa=oral args).

courtstringoptional

Court ID to filter by (e.g. "scotus", "ca7").

judgestringoptional

Filter by judge name.

order_bystringoptional

Sort order (e.g. "score desc", "dateFiled desc", "dateFiled asc", "citeCount desc").

filed_afterstringoptional

Only results filed on or after this date (YYYY-MM-DD).

filed_beforestringoptional

Only results filed on or before this date (YYYY-MM-DD).

API Usage

curl -X POST "https://skill.askfaro.com/skills/case-law/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Search Supreme Court opinions about free speech"
  }
}'

CLI Usage

askfaro describe case-law/search

Install pip install askfaro-cli, then askfaro auth login.

▶opinion

Get the full text and metadata of a court opinion by ID.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Get the full text of opinion 2812209”
  • “Show the opinion record for this ID”
  • “Read this court opinion”

Parameters

idintegerrequired

CourtListener opinion ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/case-law/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get the full text of opinion 2812209"
  }
}'

CLI Usage

askfaro describe case-law/opinion

Install pip install askfaro-cli, then askfaro auth login.

▶cluster

Get an opinion cluster (a decision and its grouped opinions) by ID.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Get opinion cluster 112332”
  • “Show the case metadata and citations for this cluster”
  • “List the opinions in this decision”

Parameters

idintegerrequired

CourtListener opinion cluster ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/case-law/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get opinion cluster 112332"
  }
}'

CLI Usage

askfaro describe case-law/cluster

Install pip install askfaro-cli, then askfaro auth login.

▶docket

Get a docket (the case record and its filings) by ID.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Get docket 4214664”
  • “Show the case record and parties for this docket”
  • “What court is this docket in?”

Parameters

idintegerrequired

CourtListener docket ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/case-law/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get docket 4214664"
  }
}'

CLI Usage

askfaro describe case-law/docket

Install pip install askfaro-cli, then askfaro auth login.