Special Collection

Filter cases by special collection

Filter by special collection (integer).

GET https://clearinghouse.net/api/v1/case?special_collection=special_collection_id

Query Parameters

Name	Type	Description
special_collection*	integer	special_collection (see list below for list of integers and its mapped values)

Headers

Name	Type	Description
Authorization*	String	Authorization Token XXXXXXXXXXX where XXXXXXXXXXX is the token string

200 Cases successfully retrieved

400: Bad Request No results, key not found, or invalid parameter

\\ Examples of:
\\ No results, key not found, or invalid parameter

\\ No results
\\ Example query endpoint: /api/v1/cases/?case_id=1&case_ongoing=1
["No results for {'case_id': '1', 'case_ongoing': '1'}"]

\\ Key not found
\\ Example query endpoint: /api/v1/cases?test_key=1
["API Error: Key: test_key, Value: 1 not found."]

\\ Example query endpoint: /api/v1/cases/?case_id=xyz
["API Error: zxy is not an integer."]

401 Permission denied

{
    "detail":"Authentication credentials were not provided."
}

Supported special collections (special_collection_id):

5698	Private Employment Class Actions
5690	Challenges to minority benefits in Biden Administration American Rescue Plan
5654	California Jail Population Caps
5652	EEOC Study — in sample
5664	Post-PLRA enforceable consent decrees
5675	Trump Travel Ban Challenges
5672	Solitary confinement
5669	Civil Rights Division Archival Collection
11079	Deaf or Blind in Jail/Prison
5682	Selma and Early Civil Rights Enforcement
11087	Attica Uprising Litigation
5680	Trump Administration FOIA cases
5700	Post-WalMart decisions on class certification
5671	DOJ Civil Rights Division Statements of Interest
5686	COVID-19 (novel coronavirus)
5670	California's Prisoners' Rights Bar article
5673	Stop-and-Frisk (NY)
5657	Court-ordered receiverships
5681	Criminal cases challenging FISA surveillance
5653	Contraception Insurance Mandate
5696	IWPR/Wage Project Consent Decree Study
5658	Occupy
5701	Martin Sostre cases
5668	Fines/Fees/Bail Reform (Criminalization of Poverty)
5685	Flint Water Cases
5659	Foreign Intelligence Surveillance Act -- All Matters
5663	Foreign Intelligence Surveillance Act—Foreign Targeting (702, 703, 704)
5661	Foreign Intelligence Surveillance Act—Internet Metadata
5660	Foreign Intelligence Surveillance Act -- Telephony Metadata
5662	Foreign Intelligence Surveillance Court
5689	Healthy Elections COVID litigation tracker
33558	Hepatitis C Treatment in Jails and Prisons
5684	Immigrant Detention Labor Issues
11093	Law Firm Antiracism Alliance (LFAA) project
5688	Litigation Against Federal Police (2020)
5679	Mass import from DOJ Spreadsheets
5699	Olmstead Cases
5677	Planned Parenthood Litigation
5687	Police Violence Protests
5665	Post-PLRA Jail and Prison Private Settlement Agreements
5655	Prison Legal News
5702	Same-Sex Marriage
38197	Multi-LexSum (in sample)
5697	Strip Search Cases
5666	Non-Litigation Policies
5674	Transgender Bathroom Access Cases
5676	Trump Immigration Enforcement Order Challenges
5667	Signal International Guest Worker Cases
5683	Title IX, Sexual Violence Investigations/Resolutions
38189	Featured Historical Cases

For more information about special collections, see special_collections.

Example

URL

https://clearinghouse.net/api/v1/case?special_collection=5683

python

import requests

url = "https://clearinghouse.net/api/v1/case?special_collection=5683"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)