> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.clearinghouse.net/api-reference-v2p1/endpoints/special-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.