Skip to main content
POST
/
api
/
courtlistener
/
opinions
/
search
/courtlistener/opinions/search
curl --request POST \
  --url https://api.anysite.io/api/courtlistener/opinions/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "<string>",
  "court": "scotus",
  "judge": "<string>",
  "case_name": "<string>",
  "docket_number": "<string>",
  "citation": "576 U.S. 644",
  "neutral_cite": "<string>",
  "filed_after": "<string>",
  "filed_before": "<string>",
  "cited_gt": 1,
  "cited_lt": 1,
  "order_by": "score desc"
}
'
[
  {
    "cluster_id": 123,
    "@type": "CourtlistenerOpinion",
    "docket_id": 123,
    "case_name": "<string>",
    "case_name_full": "<string>",
    "court": "<string>",
    "court_id": "<string>",
    "court_citation_string": "<string>",
    "court_jurisdiction": "<string>",
    "docket_number": "<string>",
    "judge": "<string>",
    "attorney": "<string>",
    "citations": [],
    "lexis_cite": "<string>",
    "neutral_cite": "<string>",
    "cite_count": 0,
    "status": "<string>",
    "source": "<string>",
    "scdb_id": "<string>",
    "posture": "<string>",
    "procedural_history": "<string>",
    "suit_nature": "<string>",
    "syllabus": "<string>",
    "panel_ids": [],
    "panel_names": [],
    "non_participating_judge_ids": [],
    "sibling_ids": [],
    "opinions": [],
    "filed_at": 123,
    "argued_at": 123,
    "reargued_at": 123,
    "reargument_denied_at": 123,
    "created_at": 123,
    "web_url": "<string>",
    "score": 123
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Number of opinions to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
q
string | null

Full-text query over opinion text, case name and metadata

court
string | null

Court id(s) to filter by, space-separated

Example:

"scotus"

judge
string | null

Filter by authoring or panel judge name

case_name
string | null

Filter by case name

docket_number
string | null

Filter by docket number

citation
string | null

Filter by reporter citation

Example:

"576 U.S. 644"

neutral_cite
string | null

Filter by neutral citation

filed_after
string | null

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

filed_before
string | null

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

cited_gt
integer | null

Only opinions cited more than this many times

Required range: x >= 0
cited_lt
integer | null

Only opinions cited fewer than this many times

Required range: x >= 0
status
enum<string> | null

Filter by precedential status

Available options:
Published,
Unpublished,
Errata,
Separate,
In-chambers,
Relating-to,
Unknown
order_by
enum<string>
default:score desc

Result ordering

Available options:
score desc,
dateFiled desc,
dateFiled asc,
citeCount desc,
citeCount asc,
dateArgued desc,
dateArgued asc

Response

Successful Response

cluster_id
integer
required
@type
string
default:CourtlistenerOpinion
docket_id
integer | null
case_name
string | null
case_name_full
string | null
court
string | null
court_id
string | null
court_citation_string
string | null
court_jurisdiction
string | null
docket_number
string | null
judge
string | null
attorney
string | null
citations
string[]
lexis_cite
string | null
neutral_cite
string | null
cite_count
integer
default:0
status
string | null
source
string | null
scdb_id
string | null
posture
string | null
procedural_history
string | null
suit_nature
string | null
syllabus
string | null
panel_ids
integer[]
panel_names
string[]
non_participating_judge_ids
integer[]
sibling_ids
integer[]
opinions
object[]
filed_at
integer | null
argued_at
integer | null
reargued_at
integer | null
reargument_denied_at
integer | null
created_at
integer | null
web_url
string | null
score
number | null