> For the complete documentation index, see [llms.txt](https://api.clearinghouse.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.clearinghouse.net/api-reference-v2p1/endpoints/special-collection.md).

# Special Collection

## Filter by special collection (integer).

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases?special_collection=special_collection_id`

#### Query Parameters

| Name                                                  | Type    | Description                                                                     |
| ----------------------------------------------------- | ------- | ------------------------------------------------------------------------------- |
| special\_collection<mark style="color:red;">\*</mark> | integer | special\_collection (see list below for list of integers and its mapped values) |

#### Headers

| Name                                            | Type   | Description                                                                                                                    |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | <p>Authorization</p><p><code>Token XXXXXXXXXXX</code></p><p>where</p><p><code>XXXXXXXXXXX</code></p><p>is the token string</p> |

{% tabs %}
{% tab title="200 Cases successfully retrieved" %}

{% endtab %}

{% tab title="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/v2p1/cases/?case_id=1&case_ongoing=1
["No results for {'case_id': '1', 'case_ongoing': '1'}"]

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

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

{% endtab %}

{% tab title="401 Permission denied" %}

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

{% endtab %}
{% endtabs %}

Supported special collections (special\_collection\_id):

<table><thead><tr><th width="87.066650390625">ID</th><th>Value</th></tr></thead><tbody><tr><td>39004</td><td>Trump Administration 2.0: Challenges to the Government | FOIA</td></tr><tr><td>5670</td><td>California's Prisoners' Rights Bar article</td></tr><tr><td>5690</td><td>Biden Administration American Rescue Plan--minority benefits challenges</td></tr><tr><td>5698</td><td>Private Employment Class Actions</td></tr><tr><td>5664</td><td>Post-PLRA enforceable consent decrees</td></tr><tr><td>5657</td><td>Court-ordered receiverships</td></tr><tr><td>5682</td><td>Selma and Early Civil Rights Enforcement</td></tr><tr><td>5654</td><td>California Jail Population Caps</td></tr><tr><td>5700</td><td>Post-WalMart decisions on class certification</td></tr><tr><td>38923</td><td>Trump Administration 2.0: Challenges to the Government | Authority of Independent Agencies</td></tr><tr><td>38916</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Appointments/Civil Service/Labor</td></tr><tr><td>5681</td><td>Criminal cases challenging FISA surveillance</td></tr><tr><td>38540</td><td>Abortion Trigger Ban Cases</td></tr><tr><td>38882</td><td>Trump Administration 2.0: Challenges to the Government | Diversity/Equity/Inclusion/Accessibility (DEIA) and/or Antisemitism</td></tr><tr><td>38958</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Anti-discrimination case</td></tr><tr><td>38954</td><td>Trump Administration 2.0: Challenges to the Government | Visa revocation</td></tr><tr><td>38529</td><td>Biden Student Loan Forgiveness Plan challenges</td></tr><tr><td>5666</td><td>Non-Litigation Policies</td></tr><tr><td>5655</td><td>Prison Legal News</td></tr><tr><td>5665</td><td>Post-PLRA Jail and Prison Private Settlement Agreements</td></tr><tr><td>38630</td><td>Juvenile Parole</td></tr><tr><td>5697</td><td>Strip Search Cases</td></tr><tr><td>5675</td><td>Trump Administration 1.0: Travel Ban Challenges</td></tr><tr><td>39005</td><td>Trump Administration 2.0: Challenges to the Government | Health Care Access</td></tr><tr><td>5672</td><td>Solitary confinement</td></tr><tr><td>38544</td><td>Transgender Healthcare Access Cases</td></tr><tr><td>33558</td><td>Hepatitis C Treatment in Jails and Prisons</td></tr><tr><td>38640</td><td>Traffic Stop Litigation</td></tr><tr><td>5696</td><td>IWPR/Wage Project Consent Decree Study</td></tr><tr><td>11079</td><td>Deaf or Blind in Jail/Prison</td></tr><tr><td>5671</td><td>DOJ Civil Rights Division Statements of Interest</td></tr><tr><td>11087</td><td>Attica Uprising Litigation</td></tr><tr><td>39016</td><td>Donald Trump personal capacity lawsuits</td></tr><tr><td>39017</td><td>Donald Trump personal capacity lawsuits | Libel/defamation claims</td></tr><tr><td>39028</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation</td></tr><tr><td>5653</td><td>Contraception Insurance Mandate</td></tr><tr><td>38911</td><td>Trump Administration 2.0: Challenges to the Government | Environmental Protections</td></tr><tr><td>5687</td><td>Police Violence Protests</td></tr><tr><td>5674</td><td>Transgender Bathroom Access Cases</td></tr><tr><td>38877</td><td>Trump Administration 2.0: Challenges to the Government | Appointments/Civil Service</td></tr><tr><td>39018</td><td>Donald Trump personal capacity lawsuits | General</td></tr><tr><td>39043</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | General</td></tr><tr><td>39030</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Equal Employment</td></tr><tr><td>5669</td><td>Civil Rights Division Archival Collection</td></tr><tr><td>39044</td><td>Trump Administration 2.0: Challenges to the Government | General</td></tr><tr><td>39045</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Miscellaneous</td></tr><tr><td>39031</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | State &#x26; Local Policing</td></tr><tr><td>5686</td><td>COVID-19 (novel coronavirus)</td></tr><tr><td>39032</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | School Desegregation</td></tr><tr><td>39033</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Reproductive Rights</td></tr><tr><td>39034</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Fair Lending</td></tr><tr><td>38880</td><td>Trump Administration 2.0: Challenges to the Government | Immigration Enforcement</td></tr><tr><td>38881</td><td>Trump Administration 2.0: Challenges to the Government | Spending Freezes/Cuts</td></tr><tr><td>39035</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Deregulation</td></tr><tr><td>5701</td><td>Martin Sostre cases</td></tr><tr><td>39036</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Disability Rights</td></tr><tr><td>5660</td><td>Foreign Intelligence Surveillance Act -- Telephony Metadata</td></tr><tr><td>39037</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Transgender Rights</td></tr><tr><td>5652</td><td>EEOC Study — in sample</td></tr><tr><td>5668</td><td>Fines/Fees/Bail Reform (Criminalization of Poverty)</td></tr><tr><td>5663</td><td>Foreign Intelligence Surveillance Act—Foreign Targeting (702, 703, 704)</td></tr><tr><td>5662</td><td>Foreign Intelligence Surveillance Court</td></tr><tr><td>39038</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Environmental Justice</td></tr><tr><td>5702</td><td>Same-Sex Marriage</td></tr><tr><td>39039</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Conditions of Confinement</td></tr><tr><td>5684</td><td>Immigrant Detention Labor Issues</td></tr><tr><td>38876</td><td>Trump Administration 2.0: Challenges to the Government | Birthright Citizenship</td></tr><tr><td>39040</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Anti-Semitism</td></tr><tr><td>5673</td><td>Stop-and-Frisk (NY)</td></tr><tr><td>5680</td><td>Trump Administration 1.0 &#x26; 2.0 FOIA cases</td></tr><tr><td>38808</td><td>Trump Administration 1.0: Challenges to the Government</td></tr><tr><td>39041</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Criminal Cases</td></tr><tr><td>38932</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Anti-semitism/DEIA</td></tr><tr><td>38948</td><td>Trump Administration 2.0: Challenges to the Government | Tariffs &#x26; Trade</td></tr><tr><td>38940</td><td>Trump Administration 2.0: Challenges to the Government | Grant/Contract rescissions, Defunding or Other Threats against Private Entities</td></tr><tr><td>38878</td><td>Trump Administration 2.0: Challenges to the Government | DOGE Status/Information Access</td></tr><tr><td>38879</td><td>Trump Administration 2.0: Challenges to the Government | Transgender Rights</td></tr><tr><td>38952</td><td>Trump Administration 2.0: Challenges to the Government | Voting/Election Law</td></tr><tr><td>38953</td><td>Trump Administration 2.0: Challenges to the Government | Alien Enemies Act</td></tr><tr><td>39029</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Immigration</td></tr><tr><td>39042</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Voting Rights</td></tr><tr><td>39055</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Criminal Prosecutions</td></tr><tr><td>39053</td><td>Trump Administration 2.0: Litigation and Investigations By the Government</td></tr><tr><td>39056</td><td>Trump Administration 2.0: Reversing Course on Existing Litigation | Criminal Prosecutions</td></tr><tr><td>39064</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Immigration Enforcement</td></tr><tr><td>39089</td><td>Title VI Anti-Palestinian/Antisemitism cases</td></tr><tr><td>38197</td><td>Multi-LexSum (in sample)</td></tr><tr><td>5658</td><td>Occupy</td></tr><tr><td>39065</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Anti-discrimination case</td></tr><tr><td>38760</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government</td></tr><tr><td>5676</td><td>Trump 1.0 &#x26; 2.0 Immigration Enforcement Order Challenges</td></tr><tr><td>38883</td><td>Trump Administration 2.0: Challenges to the Government | Data Access and/or Takedowns</td></tr><tr><td>39058</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Anti-semitism/DEIA</td></tr><tr><td>39059</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Appointments/Civil Service/Labor</td></tr><tr><td>38885</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Immigration Enforcement</td></tr><tr><td>39060</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Criminal Prosecutions</td></tr><tr><td>38886</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Transgender Rights</td></tr><tr><td>39061</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | State/Local Policing</td></tr><tr><td>39062</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Transgender Rights</td></tr><tr><td>38887</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | Voting/Election Law</td></tr><tr><td>39107</td><td>Donald Trump personal capacity lawsuits | Criminal prosecution</td></tr><tr><td>39106</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | General</td></tr><tr><td>39063</td><td>Trump Administration 2.0: Litigation and Investigations By the Government | Voting/Election Law</td></tr><tr><td>38888</td><td>Trump Administration 2.0: Litigation and Investigations Involving the Government | State/Local Policing</td></tr><tr><td>39128</td><td>Operation Metro Surge</td></tr><tr><td>39118</td><td>January 6 (2021) Civil Cases</td></tr><tr><td>39131</td><td>Litigation Against Hate Groups</td></tr><tr><td>38759</td><td>Trump Administration 2.0: Challenges to the Government</td></tr><tr><td>39096</td><td>Mid-Decade Redistricting Cases</td></tr><tr><td>5685</td><td>Flint Water Cases</td></tr><tr><td>5659</td><td>Foreign Intelligence Surveillance Act -- All Matters</td></tr><tr><td>5661</td><td>Foreign Intelligence Surveillance Act—Internet Metadata</td></tr><tr><td>5689</td><td>Healthy Elections COVID litigation tracker</td></tr><tr><td>11093</td><td>Law Firm Antiracism Alliance (LFAA) project</td></tr><tr><td>5688</td><td>Litigation Against Federal Police (2020)</td></tr><tr><td>5679</td><td>Mass import from DOJ Spreadsheets</td></tr><tr><td>5699</td><td>Olmstead Cases</td></tr><tr><td>5677</td><td>Planned Parenthood Medicaid Litigation</td></tr><tr><td>5667</td><td>Signal International Guest Worker Cases</td></tr><tr><td>5683</td><td>Title IX, Sexual Violence Investigations/Resolutions</td></tr><tr><td>38189</td><td>Featured Historical Cases</td></tr></tbody></table>

For more information about special collections, see [Case Details](/api-reference-v2p1/objects/case/case-details.md#special_collections).

## **Example** <a href="#example" id="example"></a>

{% tabs %}
{% tab title="URL" %}

```
https://clearinghouse.net/api/v2p1/cases?special_collection=5683
```

{% endtab %}

{% tab title="python" %}

```
import requests

url = "https://clearinghouse.net/api/v2p1/cases?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)
```

{% endtab %}
{% endtabs %}