Skip to content

Dockets Examples

List dockets:

courtlistener-cli dockets list --limit 20
courtlistener-cli dockets list --court cand --case-name "United States" --limit 50 --format csv --output ./output
courtlistener-cli dockets list data/dockets.xlsx --column docketNumber --limit 50 --max-pages 5 --format json

Get a docket:

courtlistener-cli dockets get 4134326
courtlistener-cli dockets get 4134326 --format json

List docket entries:

courtlistener-cli dockets entries 4134326 --limit 50
courtlistener-cli dockets entries 4134326 --limit 200 --max-pages 3 --format xlsx --output ./output --filename docket_4134326_entries
courtlistener-cli dockets entries 4134326 --format csv --slim --filename docket_4134326_entries_slim

Count dockets:

courtlistener-cli dockets count
courtlistener-cli dockets count --court cand
courtlistener-cli dockets count --court cand --case-name "United States"

Download docket documents:

courtlistener-cli dockets download-docs 4134326 --output ./output
courtlistener-cli dockets download-docs 4134326 --output ./output --manifest csv
courtlistener-cli dockets download-docs 4134326 --output ./output --manifest xlsx --all-docs
courtlistener-cli dockets download-docs 4134326 --output ./output --folder-name-mode docket-id
courtlistener-cli dockets download-docs 4134326 --output ./output --folder-name-mode none

Folder naming modes:

  • case-name-number keeps the current default, for example United States v. Keeton ; 2_22-cr-00327
  • case-name writes only the case name
  • docket-number writes only the docket number
  • docket-id writes only the CourtListener docket ID
  • none writes directly into --output

For the fast CSV export path, save your browser sessionid cookie into .env as COURTLISTENER_SESSION_ID.

  1. Log in to courtlistener.com in Chrome
  2. Open DevTools and go to Application → Cookies → https://www.courtlistener.com
  3. Copy the value of the sessionid cookie
  4. Add it to .env

Chrome DevTools showing the sessionid cookie under the CourtListener domain

Export docket parties:

courtlistener-cli dockets parties 4134326
courtlistener-cli dockets parties 4134326 --format json --output ./output
courtlistener-cli dockets parties 4134326 --format xlsx --output ./output --filename docket_4134326_parties