Skip to main content
POST
/
api
/
courtlistener
/
oral-arguments
/
search
/courtlistener/oral-arguments/search
curl --request POST \
  --url https://api.anysite.io/api/courtlistener/oral-arguments/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "<string>",
  "case_name": "<string>",
  "judge": "<string>",
  "court": "ca9",
  "docket_number": "<string>",
  "argued_after": "<string>",
  "argued_before": "<string>",
  "order_by": "score desc"
}
'
[
  {
    "id": 123,
    "@type": "CourtlistenerOralArgumentResult",
    "case_name": "<string>",
    "case_name_full": "<string>",
    "court": "<string>",
    "court_id": "<string>",
    "court_citation_string": "<string>",
    "docket_id": 123,
    "docket_number": "<string>",
    "judge": "<string>",
    "duration": 123,
    "file_size_mp3": 123,
    "download_url": "<string>",
    "local_path": "<string>",
    "sha1": "<string>",
    "snippet": "<string>",
    "source": "<string>",
    "pacer_case_id": "<string>",
    "panel_ids": [],
    "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 oral arguments 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 oral argument transcripts and metadata

case_name
string | null

Filter by case name

judge
string | null

Filter by judge name

court
string | null

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

Example:

"ca9"

docket_number
string | null

Filter by docket number

argued_after
string | null

Only arguments heard on or after this date (YYYY-MM-DD)

argued_before
string | null

Only arguments heard on or before this date (YYYY-MM-DD)

order_by
enum<string>
default:score desc

Result ordering

Available options:
score desc,
dateArgued desc,
dateArgued asc

Response

Successful Response

id
integer
required
@type
string
default:CourtlistenerOralArgumentResult
case_name
string | null
case_name_full
string | null
court
string | null
court_id
string | null
court_citation_string
string | null
docket_id
integer | null
docket_number
string | null
judge
string | null
duration
integer | null
file_size_mp3
integer | null
download_url
string | null
local_path
string | null
sha1
string | null
snippet
string | null
source
string | null
pacer_case_id
string | null
panel_ids
integer[]
argued_at
integer | null
reargued_at
integer | null
reargument_denied_at
integer | null
created_at
integer | null
web_url
string | null
score
number | null