Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(api): add citation_string as a CourtFilter filter field #4588

Merged

Conversation

cweider
Copy link
Collaborator

@cweider cweider commented Oct 17, 2024

The Bluebook's court abbreviations are fairly close to an identifier. While there's a suggestion that they may not be stable – some administrative agencies have lobbied to avoid the periodization of their reporters1, they are still useful. When working directly from a citation, this is the best route to a CourtListener court id.

Footnotes

  1. Fred Jacob, Even the Federal Government Can’t Beat The Bluebook, 27 Green Bag 2d 117 (2024)

@cweider
Copy link
Collaborator Author

cweider commented Oct 17, 2024

Also worth noting that, if nothing else, it provides a path for implementers that leads them away from time-consuming queries:

% curl 'https://www.courtlistener.com/api/rest/v4/dockets/?docket_number=18-16700&court__short_name=Ninth+Circuit' | jq '.results[].case_name' 
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  9429  100  9429    0     0   3448      0  0:00:02  0:00:02 --:--:--  3448
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
% curl 'https://www.courtlistener.com/api/rest/v4/dockets/?docket_number=18-16700&court__id=ca9' | jq '.results[].case_name'
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  9429  100  9429    0     0  23591      0 --:--:-- --:--:-- --:--:-- 23631
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
% curl 'https://www.courtlistener.com/api/rest/v4/dockets/?docket_number=18-16700&court__citation_string=9th+Cir.' | jq '.results[].case_name'
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 22740  100 22740    0     0   2922      0  0:00:33  0:00:33 --:--:--  6162
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Reynaldo Gonzalez v. Google LLC"
"Marie Michelle Andre"
"CHRISTIAN SONNY KEAU ANI"
"William C. Crosley and Susan K. Crosley"
"Gregory C. Wood"
"Erica Lynn Chumbley"
"Todd W. Kihm"
"August Charles Stanley"
"Thomas Sabo"
"Reynaldo Gonzalez v. Google LLC"

The Bluebook's court abbreviations are fairly close to an identifier.
While there's a suggestion that they may not be stable[1], they are
still useful, especially when a caller is working from a citation.

[1] Fred Jacob, Even the Federal Government Can't Beat The Bluebook, 27 Green Bag 2d 117 (2024)
@cweider cweider force-pushed the api-court-filter-citation-string branch from 2b0378a to bdcf67a Compare October 17, 2024 05:28
Copy link
Member

@mlissner mlissner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Easy-peasy, thanks, merging!

@mlissner mlissner merged commit ec8bc90 into freelawproject:main Oct 17, 2024
9 checks passed
@cweider cweider deleted the api-court-filter-citation-string branch October 26, 2024 21:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants