Skip to main content
POST
/
api
/
courtlistener
/
dockets
/
search
/courtlistener/dockets/search
curl --request POST \
  --url https://api.anysite.io/api/courtlistener/dockets/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "<string>",
  "court": "cand",
  "case_name": "<string>",
  "docket_number": "<string>",
  "party_name": "<string>",
  "attorney_name": "<string>",
  "assigned_to": "<string>",
  "referred_to": "<string>",
  "nature_of_suit": "<string>",
  "cause": "<string>",
  "filed_after": "<string>",
  "filed_before": "<string>",
  "document_number": "1",
  "entry_date_filed_after": "<string>",
  "entry_date_filed_before": "<string>",
  "available_only": true,
  "order_by": "score desc"
}
'
[
  {
    "docket_id": 123,
    "@type": "CourtlistenerDocket",
    "case_name": "<string>",
    "case_name_full": "<string>",
    "docket_number": "<string>",
    "court": "<string>",
    "court_id": "<string>",
    "court_citation_string": "<string>",
    "assigned_to": "<string>",
    "assigned_to_id": 123,
    "referred_to": "<string>",
    "referred_to_id": 123,
    "suit_nature": "<string>",
    "cause": "<string>",
    "jurisdiction_type": "<string>",
    "jury_demand": "<string>",
    "chapter": "<string>",
    "trustee_str": "<string>",
    "pacer_case_id": "<string>",
    "parties": [],
    "party_ids": [],
    "attorneys": [],
    "attorney_ids": [],
    "firms": [],
    "firm_ids": [],
    "recap_documents": [],
    "filed_at": 123,
    "argued_at": 123,
    "terminated_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 dockets 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 docket and document text

court
string | null

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

Example:

"cand"

case_name
string | null

Filter by case name

docket_number
string | null

Filter by docket number

party_name
string | null

Filter by party name

attorney_name
string | null

Filter by attorney name

assigned_to
string | null

Filter by assigned judge name

referred_to
string | null

Filter by referred judge name

nature_of_suit
string | null

Filter by nature of suit

cause
string | null

Filter by cause of action

filed_after
string | null

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

filed_before
string | null

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

document_number
string | null

Filter by a document number within the docket

Example:

"1"

entry_date_filed_after
string | null

Only dockets with a document entry filed on or after this date (YYYY-MM-DD)

entry_date_filed_before
string | null

Only dockets with a document entry filed on or before this date (YYYY-MM-DD)

available_only
boolean | null

Only cases with documents available for free download when true

order_by
enum<string>
default:score desc

Result ordering

Available options:
score desc,
dateFiled desc,
dateFiled asc

Response

Successful Response

docket_id
integer
required
@type
string
default:CourtlistenerDocket
case_name
string | null
case_name_full
string | null
docket_number
string | null
court
string | null
court_id
string | null
court_citation_string
string | null
assigned_to
string | null
assigned_to_id
integer | null
referred_to
string | null
referred_to_id
integer | null
suit_nature
string | null
cause
string | null
jurisdiction_type
string | null
jury_demand
string | null
chapter
string | null
trustee_str
string | null
pacer_case_id
string | null
parties
string[]
party_ids
integer[]
attorneys
string[]
attorney_ids
integer[]
firms
string[]
firm_ids
integer[]
recap_documents
object[]
filed_at
integer | null
argued_at
integer | null
terminated_at
integer | null
created_at
integer | null
web_url
string | null
score
number | null