Skip to main content
POST
/
api
/
courtlistener
/
judges
/
search
/courtlistener/judges/search
curl --request POST \
  --url https://api.anysite.io/api/courtlistener/judges/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "name": "<string>",
  "court": "cand",
  "dob_after": "<string>",
  "dob_before": "<string>",
  "dob_city": "<string>",
  "dob_state": "CA",
  "school": "<string>",
  "appointer": "<string>",
  "order_by": "score desc"
}
'
[
  {
    "id": 123,
    "@type": "CourtlistenerJudgeResult",
    "name": "<string>",
    "gender": "<string>",
    "religion": "<string>",
    "races": [],
    "aliases": [],
    "schools": [],
    "aba_ratings": [],
    "political_affiliations": [],
    "fjc_id": "<string>",
    "born_at": 123,
    "died_at": 123,
    "dob_city": "<string>",
    "dob_state": "<string>",
    "positions": [],
    "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 judges to return

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

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
name
string | null

Filter by judge name

​
court
string | null

Court id the judge served on

Example:

"cand"

​
dob_after
string | null

Only judges born on or after this date (YYYY-MM-DD)

​
dob_before
string | null

Only judges born on or before this date (YYYY-MM-DD)

​
dob_city
string | null

Filter by city of birth

​
dob_state
string | null

Filter by two-letter state of birth

Example:

"CA"

​
school
string | null

Filter by school attended

​
appointer
string | null

Filter by the name of who appointed the judge

​
selection_method
enum<string> | null

Filter by how the judge was selected

Available options:
e_part,
e_non_part,
a_pres,
a_gov,
a_legis
​
political_affiliation
enum<string> | null

Filter by political party affiliation

Available options:
d,
r,
i,
g,
l,
f,
w,
j,
u,
z
​
order_by
enum<string>
default:score desc

Result ordering

Available options:
score desc,
name_reverse asc,
dob desc,
dob asc

Response

Successful Response

​
id
integer
required
​
@type
string
default:CourtlistenerJudgeResult
​
name
string | null
​
gender
string | null
​
religion
string | null
​
races
string[]
​
aliases
string[]
​
schools
string[]
​
aba_ratings
string[]
​
political_affiliations
string[]
​
fjc_id
string | null
​
born_at
integer | null
​
died_at
integer | null
​
dob_city
string | null
​
dob_state
string | null
​
positions
object[]
​
web_url
string | null
​
score
number | null