# Overview

{% hint style="warning" %}
As of 1/19/2026, the Clearinghouse will no longer support V2. Please update your integration to use V2.1.
{% endhint %}

The Civil Rights Litigation Clearinghouse API **(CRLCA)** allows anyone to access civil rights litigation information and documents for free.

This documentation explains everything you need to know about the CRLCA.

## Want to jump right in?

Feeling like an eager beaver? Jump in to the quick start docs and get making your first request.

## Flattened docs endpoint

This endpoint serves a flattened text version of all documentation pages combined into a single file.

[Flattened docs endpoint](https://api.clearinghouse.net/llms-full.txt)

## Want to deep dive?

Dive a little deeper and start exploring our API reference to get an idea of everything that's possible with the API:


# Quick Start

## Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

The first step is to create a user account through the Clearinghouse website, <https://clearinghouse.net/registration>.\
Then you can request an API key, <https://www.clearinghouse.net/api-request>.

Once the request is accepted, you will receive an email from `info@clearinghouse.net` with your token.

## Authentication

There are two methods of authentication CRLCA has available:

* Token Authentication
* Session Authentication

The following sections will go over how to make your first request using both authentication methods.

## Token Authentication - Make your first request

Token authentication authenticates based the token you have received via email from `info@clearinghouse.net`.

To make your first request, send an authenticated request to the hello endpoint.

## Get test.

<mark style="color:blue;">`GET`</mark> `https://www.clearinghouse.net/api/v2p1/test`

Test endpoint for API connection verification

#### 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 Successfully connected" %}

```javascript
{
"message": "Success, you have access to the Civil Rights Clearinghouse Litigation API!"
}
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

Take a look at how you might call this method using python or `curl`:

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

```
import requests

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

print(response.text)
```

{% endtab %}

{% tab title="curl" %}

```
curl https://www.clearinghouse.net/api/v2p1/test/ 
    -H 'Authorization: Token XXXXXXXXXXXXXXX'
```

{% endtab %}
{% endtabs %}

## Session Authentication

Session authentication authenticates based on your Civil Rights Clearinghouse Litigation website login credentials.

{% hint style="info" %}
**Recommendation:** Session authentication is a great way to navigate available CRCLA requests using the web browser.
{% endhint %}

To make your first request, make sure you are logged onto your Civil Rights Clearinghouse Litigation account. You can access the authentication request to the following endpoint: [https://www.clearinghouse.net/api/v2p1/test.](https://clearinghouse.net/api/v2/test)

You should see the following the data returned:

`{ "message": "Success, you have access to the Civil Rights Clearinghouse Litigation API!"`


# Change Log

7/3/2026

* Inactive objects are no longer retrieved by default on dockets, case defendants, and cases endpoints, and the corresponding `is_active` fields for each object are removed.
* Fixed various documentation inaccuracies.
* Removed `is_active` field on docket, case defendant, and case objects.
* The dockets endpoint no longer includes inactive dockets.

6/20/26 - Updated `special_collections` field in Cases and Resource endpoint to match the documented representation of values. Since 6/5/26 the fields were documented to return an array of string values, but they were returning an array of mappings like `{value: ...}` .

6/16/26 - Improved error message when invalid filter is used in the cases endpoint.

6/16/26 - Added `relief_sought` field to cases.

6/15/26 - Moved "Rate limits" documentation from the how-to.

6/5/26&#x20;

* Added documents endpoint GET `/api/v2p1/documents/` with filters: `case_id`, `docket_id`, `title`, `is_core_document`, `document_type`, `born_digital_status`, and `text` (full-text search).&#x20;
* Updated `special_collections` field on Case and Resource to include subcategory where available, formatted as `"Collection Name | Subcategory"`.
* Updated documented list of special collections to match the format above.
* Paginated responses now include a `count` field indicating the total number of results.
* Added search parameter `text` (full-text search) to Cases endpoint.

5/28/26&#x20;

* Added document detail endpoint `GET /api/v2p1/documents/{id}/`, returning full document record including text.
* Fixed ordering of Cases, Case Documents, Case Dockets endpoints to be stable and consistent.
* Added search parameter `filing_year` to Cases endpoint.
* Added `case_name` to the top-level response on the Case Documents endpoint, representing the case name as retrieved from the associated case, as opposed to the `case_name` that is retrieved from the document.
* Added `last_updated` field to dockets.
* Added `case_name` and `dockets` fields to Document.
* Added `court_list` field to Case.
* Made `court` param in cases endpoint filter against the full court list instead of just the main court.

5/20/26 - Added `summary_authors` field to Case.

5/20/26 - Added search parameter `relief_sought` to Cases endpoint.

5/20/26 - Added search parameter `appellate_court_litigation_status` to Cases endpoint.

5/20/26 - Added search parameter `trial_court_litigation_status` to Cases endpoint.

5/20/26 - Added search parameter `summary_author` to Cases endpoint.

5/20/26 - Added search parameter `plaintiff_description` to Cases endpoint.

5/20/26 - Added search parameters `terminating_date_from` and `terminating_date_to` to Cases endpoint.

5/20/26 - Added search parameters `settlement_judgment_date_from` and `settlement_judgment_date_to` to Cases endpoint.

5/20/26 - Added search parameters `filing_date_from` and `filing_date_to` to Cases endpoint.

5/20/26 - Added search parameter name to Cases endpoint.

5/12/26 - Deprecated `last_checked_date` (will be removed in v2.3). `last_checked_date` will continue to alias `update_as_of_date` until the deprecation period is over.

5/12/26 - Added `update_as_of_date` field to `Case` .

4/20/26 - Added `court_level_summaries` field to `Case`.

4/20/26 - Added ability to filter cases by `court_level_summary`.

2/24/26 - Added additional fields to query. `docket_year`, `docket_filing_number` and `docket_office_number` are now supported at the case query endpoint. Dockets can now also be queried without a `case_id` and instead using a `recap_ip`.

1/8/26 - V2p1 documentation API optimized to handle more traffic.

7/9/25 - V2 API released.

6/16/23 - Added descriptions for `plaintiff_type`, `defendant_type`, `facility_type`, `constitutional_clause`, `special_case_type`, `content_of_injunction` (Issues).

6/16/23 - Fixed value in Document object documentation

6/15/23 - Finished cause of action table in Case object documentation

6/5/23 - Filled in more causes of action in Case object documentation

6/2/23 - Filled in more causes of action in Case object documentation

6/2/23 - Added subsections in Case object documentation for `is_active`, `plaintiff_type`, `defendant_type`, `facility_type`, `constitutional_clause`, `special_case_type`, `content_of_injunction`.

6/1/23 - Added descriptions for document ID and status in Document Details

6/1/23 - Added "Withdrawn" as option for "Class Action Outcome"/`class_action_granted`

5/26/23 - Fixed typo and added UTF-8 encoding notes in JSON to CSV tutorial.

4/4/23 - Added documentation in "Objects" section (and removed "under construction" disclaimers).

3/30/23 - Added Translating Search URL into API Query section.

3/28/23 - Modified Python requests example to include user agent.

3/15/23 - Modified endpoint names to match clearinghouse.net search bar so it can be mapped one to one. Also updated all the error handling messages and documentation to match current state of API.

2/21/23 - Added Embedding PDF Documents section and following fields:

* summary\_updated\_date
* related\_cases
* summary\_authors
* docket state
* docket court
* docket scales\_html
* docket entries
* document party types

2/16/23 - Includes ability to filter:

* case prevailing party
* case ongoing
* case available documents
* case defendant type
* case plaintiff type
* case defendant level
* case facility type
* case constitutional clause
* case content of injunction
* case special case type
* case status
* document type
* court

1/20/23 - Fixed typo in documentation. Includes ability to filter:

* case filed pro se
* case class action sought
* case class action outcome
* case public interest lawyer

11/17/22 - Added ability to query multiple fields at once.

11/16/22 - Includes ability to filter:

* case relief nature
* case relief source
* case custom issue

11/15/22 - Includes ability to filter:

* case issues
* case settlement status
* case attorney organization

11/8/22 - Includes ability to:

* Filter case type regardless of if case type is listed as a primary or secondary case type
* Filter by case state and special collection

8/24/22 Beta Release - Includes ability to filter case by ID, type, and cause of action.


# Deprecations

## Features slated for removal in v2.2

`Case.last_checked_date` is deprecated in favor of `Case.update_as_of_date` . During the deprecation period, `last_checked_date` will be kept as an alias of `update_as_of_date`.


# Rate Limits

All API requests are limited to **60 requests per minute per API key**.

If the limit is exceeded, the API returns:

`HTTP 429 Too Many Requests`

Wait until the rate limit window resets before retrying.


# How-To Guides

These subpages contain quick guides for things you might want to do with the Clearinghouse API.


# Querying Multiple Fields

In order to query multiple fields at once, use `&`

For example:

```
https://clearinghouse.net/api/v2p1/cases?case_type=5033&state=5810
```


# Translating a Search URL into an API Query

If you have a search query on the Clearinghouse website that you'd like to translate into an equivalent API query, grab the url link from the search bar.

For example, if I did a search on 'Policing' case types and the 'Occupy' special collection, you would do the following on the website:

<figure><img src="/files/xi9qU2unQBJ82Q0ABWwk" alt=""><figcaption></figcaption></figure>

Take a look at the search bar and you will see the following url:

```markup
https://clearinghouse.net/search/case/?case_type=5039&special_collection=5658&ordering=-summary_approved_date
```

The important thing to notice is `case_type=5039` and `special_collection=5658`in the url. If you look up the [Case Type Endpoint](/api-reference-v2p1/endpoints/case-type) and [Special Collection Endpoint,](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference/endpoints/special-collection.md) you will see 5039 correlates to **Policing** and 5658 correlates to **Occupy**. This can be translated into the following API query:

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

```
https://clearinghouse.net/api/v2p1/cases?case_type=5039&special_collection=5658
```

{% endtab %}

{% tab title="python" %}

```
import requests

url = "https://clearinghouse.net/api/v2p1/cases?case_type=5039&special_collection=5658"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Converting JSON to CSV

The Clearinghouse API returns data in JSON, which saves data in name-value pairs. The output is a list ("array") of cases, where each case is a dictionary -- that's where the name-value pairs come into play. (For more general information about JSON, see [here](https://www.w3schools.com/whatis/whatis_json.asp).)

If you want to look at the API output in a spreadsheet, you'll want to convert the JSON data to CSV. There are numerous "JSON to CSV" converters online, but with larger JSON files, these online converters may be slow or unable to handle very large files. This guide demonstrates how to use Python to convert JSON to CSV.

## Reading a JSON File

If you already use Python to call the API and are looking to manipulate the data in the same stretch of code, skip this section.

If you have saved your API output as a JSON file, then the first step is to read the file:

```python
import json

# Replace "your-file.json" with your JSON file name
with open("your-file.json") as f:
    json_data = json.load(f)
```

{% hint style="info" %}
When reading data, you may find it helpful to decode the data from UTF-8. You can do this with `open("your-file.json", encoding="utf-8")`.
{% endhint %}

You now have a list of case dictionaries in `json_data`.

## Writing a CSV File

Next, you'll write a CSV file based on the loaded JSON data. The idea is to make a CSV header row out of the names in the name-value pairs of the JSON data and to create a row for every case.

Note: The following code snippet requires Python 3.7 or higher. (Python dictionaries are ordered as of Python 3.7.)

```python
import csv

# Replace "new-csv-file.csv" with your desired output file name
with open("new-csv-file.csv", "w") as f:
    writer = csv.writer(f)

    # Write header row of CSV file based on first case in list
    writer.writerow(json_data[0].keys())

    # Iterate through case list to write CSV rows
    for case in json_data:
        writer.writerow(case.values())
```

{% hint style="info" %}
When writing data, you may find it helpful to encode the data as UTF-8. You can do this with `open("new-csv-file.csv", "w", encoding="utf-8")`.
{% endhint %}

You now have a CSV file you can open as a spreadsheet.

### Picking Specific Fields

Because opening a large CSV file in, say, Excel might be a little unwieldy, you can also pick and choose which case fields you want in your CSV file. If you want to go this route, this replaces the code snippet above.

For example, if you want to create a CSV file that contains only the id and summary for every case, here's what that would look like:

```python
import csv

# For more fields that you can add, see
# https://api.clearinghouse.net/api-reference/objects/case
fields = [
    "id",
    "summary",
]

# Replace "new-csv-file.csv" with your desired output file name
with open("new-csv-file.csv", "w") as f:
    writer = csv.writer(f)

    # Write header row
    writer.writerow(fields)

    for case in json_data:
        row = [case[field] for field in fields]
        writer.writerow(row)
```


# Embedding PDF Documents

Using an example, this page will go over how to embed a PDF of a document's been retrieved from an API query.

If in the API query retrieved, the following link may be imbedded in the GET response:

{% code overflow="wrap" %}

```json
"file":"https://clearinghouse-umich-production.s3.amazonaws.com/media/doc/1865.pdf"
```

{% endcode %}

To embed this link into an HTML page, add the following:

<pre class="language-html" data-overflow="wrap"><code class="lang-html"><strong>&#x3C;embed src="https://clearinghouse-umich-production.s3.amazonaws.com/media/doc/1865.pdf#toolbar=1&#x26;navpanes=0&#x26;scrollbar=0" width='100%' style='min-height: 740px;' type="application/pdf">
</strong></code></pre>


# API Reference V2.1

Welcome to **API v2.1**! This version introduces several improvements designed to make the API faster and more scalable.

To learn more about it, see [New Features](/api-reference-v2p1/new-features).


# New Features

CRCLA V2.1 introduces several improvements designed to make the API faster and more scalable.

## Key Highlights

* **Improved Performance:** Endpoints now return lighter responses by moving large related datasets to paginated URLs.
* **Versioning:** All v2.1 endpoints are available under the `/api/v2p1/` namespace.
* **Hyperlinked Relationships:** Instead of embedding large nested arrays, related records are now referenced by hyperlinks you can query separately.

***

## Changes to Related Endpoints

To speed up queries and improve response times, three fields that previously returned all records inline have been updated to provide paginated URLs instead.

| Field                | Type         | Documentation Link                                                                           |
| -------------------- | ------------ | -------------------------------------------------------------------------------------------- |
| `case_documents_url` | string (URL) | [#case\_documents\_url](/api-reference-v2p1/objects/case/pagination-urls#case_documents_url) |
| `case_dockets_url`   | string (URL) | [#case\_dockets\_url](/api-reference-v2p1/objects/case/pagination-urls#case_dockets_url)     |
| `case_resources_url` | string (URL) | [#case\_resources\_url](/api-reference-v2p1/objects/case/pagination-urls#case_resources_url) |

These fields now return a link you can follow to retrieve related records in a paginated format.

To learn more about pagination behavior, see [Pagination](/api-reference-v2p1/new-features/pagination).

### Removed Fields

As part of this change, a few fields that previously contained large serialized data has been removed and replaced by the URL fields listed above:

* `case_documents`
* `case_dockets`
* `case_resources`

If your integration relied on these fields, you will now need to follow the corresponding URL to retrieve related records.

***

### Query Related Records Directly

In addition to using the `*_url` fields returned in each `Case` object, you can also **query related records directly by filtering on the `case` parameter**.

This allows you to retrieve all related resources for a case without relying only on hyperlinks.

#### Examples

* Retrieve all resources for a specific case: `/api/v2p1/cases/11085/resources/`
* Retrieve all documents for a specific case: `/api/v2p1/cases/11085/documents/`
* Retrieve all dockets for a specific case: `/api/v2p1/cases/11085/dockets`

where `11085` is a case id.

To learn more about query behavior, see [Query Behavior](/api-reference-v2p1/new-features/query-behavior).

***

### Accessing Extracted Text from Documents

The documents endpoint returns a paginated list of document objects in results. Each document object now includes new `has_text` and `text_url` fields that provide access to extracted document text (OCR or transcription), when available.

To learn more about these fields, see [Text URL](/api-reference-v2p1/objects/document/text-url)


# Pagination

All API v2.1 list endpoints return paginated responses by default. This improves performance and ensures that large datasets can be retrieved efficiently.

***

## How Pagination Works

Every list endpoint responds with a standardized JSON structure that includes:

* `next`: the URL to fetch the next page (or `null` if there is no next page)
* `previous`: the URL to fetch the previous page (or `null` if you are on the first page)
* `results`: an array containing the records in the current page

{% hint style="warning" %}
The `count` field is now deprecated because the API is now using Cursor Pagination.
{% endhint %}

***

## Example Paginated Response of a Case Query:

```json
{
  "next": "https://clearinghouse.net/api/v2p1/cases/?case_type=7811&cursor=cD00Njg2Mg%3D%3D&no_cache=1",
  "previous": "https://clearinghouse.net/api/v2p1/cases/?case_type=7811&cursor=cj0xJnA9NDY5MjQ%3D&no_cache=1",
  "results": [
    {
      "id": 15150,
      "name": "Pottinger v. City of Miami",     
      "case_documents_url": "https://clearinghouse.net/api/v2p1/cases/46862/documents/", // URL to retrieve documents related to this case.
      "case_dockets_url": "https://clearinghouse.net/api/v2p1/cases/46862/dockets/", // URL to retrieve documents related to this case.
      "case_resources_url": "https://clearinghouse.net/api/v2p1/cases/46862/resources/" // URL to retrieve documents related to this case.
      "...": "..."
    },
    ...
    // More cases here
  ]
}

```


# Query Behavior

API v2.1 supports flexible query parameters so you can filter and retrieve exactly the records you need.

## Filtering

You can retrieve resources, documents, and dockets associated with a specific case by including the case parameter in your request. You may also retreive dockets via their RECAP ID. For example:

* **Filter cases by type:** `/api/v2p1/cases/?case_type=5039`
* **Filter resources associated with a specific case:** `/api/v2p1/cases/11085/resources`
* **Filter dockets associated with a specific case:** `/api/v2p1/cases/11085/dockets`
* **Filter dockets associated with a recap\_id:** `/api/v2p1/dockets/?recap_id=72085714`
* **Filter documents associated with a specific case:** `/api/v2p1/cases/11085/documents`

{% hint style="warning" %}
You cannot filter `document`, `resources`, and `dockets` without specifying a case (with the exception of searching for recap\_id via dockets. See note above.)

**For example:** `/api/v2p1/documents/?document_status=Approved` Will return

```
{
  "detail": "Not found."
}
```

{% endhint %}

When accessing the URL endpoints for resources, documents, or dockets, please refer to these pages for detailed response examples:

* [Documents](/api-reference-v2p1/objects/document)
* [Resources](/api-reference-v2p1/objects/resource)
* [Dockets](/api-reference-v2p1/objects/docket)


# Endpoints


# Case ID

Get case by ID

## Get Case by ID (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?case_id=18003
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}

##


# Case Ongoing

Filter cases by whether they're ongoing or closed

## Get get by case ongoing status ID (integer).

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

#### 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 Case 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 ongoing statuses (case\_ongoing\_id):

| 5020 | No                        |
| ---- | ------------------------- |
| 5024 | Perhaps, but long-dormant |
| 5022 | Unknown                   |
| 5021 | Yes                       |
| 5023 | No reason to think so     |

For more information on these statuses, see [Case Details](/api-reference-v2p1/objects/case/case-details#case_ongoing).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?case_ongoing=5023
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}

##


# Case Type

Filter cases by case type

## Filter by case type (integer).

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

#### Query Parameters

| Name                                         | Type    | Description                                                           |
| -------------------------------------------- | ------- | --------------------------------------------------------------------- |
| case\_type<mark style="color:red;">\*</mark> | integer | case type (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 List of 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 case types (case\_type\_id):

| **5033** | Mental Health (Facility)             |
| -------- | ------------------------------------ |
| **5034** | Prison Conditions                    |
| **5035** | Nursing Home Conditions              |
| **5036** | Child Welfare                        |
| **5038** | Intellectual Disability (Facility)   |
| **5039** | Policing                             |
| **5041** | School Desegregation                 |
| **5042** | Election/Voting Rights               |
| **5043** | Immigration and/or the Border        |
| **5044** | Disability Rights                    |
| **5045** | Equal Employment                     |
| **5046** | Criminal Justice (Other)             |
| **5047** | Indigent Defense                     |
| **5048** | Fair Housing/Lending/Insurance       |
| **5049** | Education                            |
| **5050** | Speech and Religious Freedom         |
| **5051** | Public Benefits/Government Services  |
| **5052** | Public Accommodations/Contracting    |
| **5053** | National Security                    |
| **5054** | Presidential/Gubernatorial Authority |
| **5055** | Environmental Justice                |
| **5056** | Jail Conditions                      |
| **5057** | Public Housing                       |
| **5058** | Juvenile Institution                 |
| **7811** | Reproductive Issues                  |

For more about case types, see [Case Details](/api-reference-v2p1/objects/case/case-details#case_types).

## **Example**

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

```
https://clearinghouse.net/api/v2p1/cases?case_type=5044
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}

##


# Special Collection

Filter cases by 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#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 %}


# Case State

Filter cases by state

## Filter by state (integer).

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

#### Query Parameters

| Name                                    | Type    | Description                                                          |
| --------------------------------------- | ------- | -------------------------------------------------------------------- |
| state<mark style="color:red;">\*</mark> | integer | state id (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 states (state\_id):

| **5853** | Puerto Rico                    |
| -------- | ------------------------------ |
| **5860** | Utah                           |
| **5863** | Vermont                        |
| **5865** | Wisconsin                      |
| **5810** | California                     |
| **5836** | Minnesota                      |
| **5806** | Alabama                        |
| **5805** | Alaska                         |
| **5838** | Northern Mariana Islands       |
| **5844** | New Hampshire                  |
| **5808** | American Samoa                 |
| **5828** | Kansas                         |
| **5818** | Wyoming                        |
| **5847** | Nevada                         |
| **5809** | Arizona                        |
| **5854** | Palau                          |
| **5822** | Guam                           |
| **5846** | New Mexico                     |
| **5840** | Montana                        |
| **5842** | North Dakota                   |
| **5807** | Arkansas                       |
| **5812** | Connecticut                    |
| **5832** | Maryland                       |
| **5821** | - International -              |
| **5835** | Michigan                       |
| **5837** | Missouri                       |
| **5856** | South Carolina                 |
| **5841** | North Carolina                 |
| **5831** | Massachusetts                  |
| **5849** | Ohio                           |
| **5845** | New Jersey                     |
| **5814** | Delaware                       |
| **5839** | Mississippi                    |
| **5843** | Nebraska                       |
| **5851** | Oregon                         |
| **5813** | District of Columbia           |
| **5823** | Hawaii                         |
| **5826** | Illinois                       |
| **5825** | Idaho                          |
| **5848** | New York                       |
| **5855** | Rhode Island                   |
| **5827** | Indiana                        |
| **5829** | Kentucky                       |
| **5858** | Tennessee                      |
| **5830** | Louisiana                      |
| **5833** | Maine                          |
| **5852** | Pennsylvania                   |
| **5857** | South Dakota                   |
| **5820** | - United States (national) -   |
| **5817** | West Virginia                  |
| **5816** | Federated States of Micronesia |
| **5804** | Georgia                        |
| **5859** | Texas                          |
| **5862** | Virgin Islands                 |
| **5864** | Washington                     |
| **5861** | Virginia                       |
| **5815** | Florida                        |
| **5824** | Iowa                           |
| **5850** | Oklahoma                       |
| **5811** | Colorado                       |
| **5834** | Marshall Islands               |
| **7697** | Other                          |

For more information about case states, see [Case Details](/api-reference-v2p1/objects/case/case-details#state).

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

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

```
https://clearinghouse.net/api/v2p1/cases?state=5810
```

{% endtab %}

{% tab title="Untitled" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Court

Filter cases by court

## Filter by court (integer).

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

#### Query Parameters

| Name                                    | Type    | Description                                                          |
| --------------------------------------- | ------- | -------------------------------------------------------------------- |
| court<mark style="color:red;">\*</mark> | integer | state id (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 courts (court\_id):

| 1790 | U. S. Court of International Trade                          |
| ---- | ----------------------------------------------------------- |
| 1792 | U. S. Court of Appeals for the District of Columbia Circuit |
| 1793 | U. S. Court of Appeals for the Eighth Circuit               |
| 1794 | U. S. Court of Appeals for the Eleventh Circuit             |
| 1795 | U. S. Court of Appeals for the Federal Circuit              |
| 1796 | U. S. Court of Appeals for the Fifth Circuit                |
| 1797 | U. S. Court of Appeals for the First Circuit                |
| 1798 | U. S. Court of Appeals for the Fourth Circuit               |
| 1799 | U. S. Court of Appeals for the Ninth Circuit                |
| 1800 | U. S. Court of Appeals for the Second Circuit               |
| 1801 | U. S. Court of Appeals for the Seventh Circuit              |
| 1802 | U. S. Court of Appeals for the Sixth Circuit                |
| 1803 | U. S. Court of Appeals for the Tenth Circuit                |
| 1804 | U. S. Court of Appeals for the Third Circuit                |
| 1823 | District of Columbia                                        |
| 1827 | Central District of California                              |
| 1828 | Central District of Illinois                                |
| 1830 | District of Alaska                                          |
| 1831 | District of Arizona                                         |
| 1834 | District of Colorado                                        |
| 1835 | District of Connecticut                                     |
| 1836 | District of Delaware                                        |
| 1839 | District of Hawaii                                          |
| 1840 | District of Idaho                                           |
| 1844 | District of Kansas                                          |
| 1847 | District of Maine                                           |
| 1848 | District of Maryland                                        |
| 1849 | District of Massachusetts                                   |
| 1851 | District of Minnesota                                       |
| 1854 | District of Montana                                         |
| 1855 | District of Nebraska                                        |
| 1856 | District of Nevada                                          |
| 1857 | District of New Hampshire                                   |
| 1858 | District of New Jersey                                      |
| 1859 | District of New Mexico                                      |
| 1862 | District of North Dakota                                    |
| 1864 | District of Oregon                                          |
| 1867 | District of Puerto Rico                                     |
| 1868 | District of Rhode Island                                    |
| 1869 | District of South Carolina                                  |
| 1870 | District of South Dakota                                    |
| 1873 | District of Utah                                            |
| 1874 | District of Vermont                                         |
| 1879 | District of Wyoming                                         |
| 1880 | Eastern District of Arkansas                                |
| 1881 | Eastern District of California                              |
| 1883 | Eastern District of Kentucky                                |
| 1884 | Eastern District of Louisiana                               |
| 1885 | Eastern District of Michigan                                |
| 1886 | Eastern District of Missouri                                |
| 1887 | Eastern District of New York                                |
| 1888 | Eastern District of North Carolina                          |
| 1889 | Eastern District of Oklahoma                                |
| 1890 | Eastern District of Pennsylvania                            |
| 1892 | Eastern District of Tennessee                               |
| 1893 | Eastern District of Texas                                   |
| 1894 | Eastern District of Virginia                                |
| 1895 | Eastern District of Washington                              |
| 1896 | Eastern District of Wisconsin                               |
| 1897 | Middle District of Alabama                                  |
| 1898 | Middle District of Florida                                  |
| 1899 | Middle District of Georgia                                  |
| 1900 | Middle District of Louisiana                                |
| 1901 | Middle District of North Carolina                           |
| 1902 | Middle District of Pennsylvania                             |
| 1903 | Middle District of Tennessee                                |
| 1904 | Northern District of Alabama                                |
| 1905 | Northern District of California                             |
| 1906 | Northern District of Florida                                |
| 1907 | Northern District of Georgia                                |
| 1908 | Northern District of Illinois                               |
| 1909 | Northern District of Indiana                                |
| 1910 | Northern District of Iowa                                   |
| 1911 | Northern District of Mississippi                            |
| 1912 | Northern District of New York                               |
| 1913 | Northern District of Ohio                                   |
| 1914 | Northern District of Oklahoma                               |
| 1915 | Northern District of Texas                                  |
| 1916 | Northern District of West Virginia                          |
| 1917 | Southern District of Alabama                                |
| 1918 | Southern District of California                             |
| 1919 | Southern District of Florida                                |
| 1920 | Southern District of Georgia                                |
| 1921 | Southern District of Illinois                               |
| 1922 | Southern District of Indiana                                |
| 1923 | Southern District of Iowa                                   |
| 1924 | Southern District of Mississippi                            |
| 1925 | Southern District of New York                               |
| 1926 | Southern District of Ohio                                   |
| 1927 | Southern District of Texas                                  |
| 1928 | Southern District of West Virginia                          |
| 1929 | Western District of Arkansas                                |
| 1930 | Western District of Kentucky                                |
| 1931 | Western District of Louisiana                               |
| 1932 | Western District of Michigan                                |
| 1933 | Western District of Missouri                                |
| 1934 | Western District of New York                                |
| 1935 | Western District of North Carolina                          |
| 1936 | Western District of Oklahoma                                |
| 1937 | Western District of Pennsylvania                            |
| 1939 | Western District of Tennessee                               |
| 1940 | Western District of Texas                                   |
| 1941 | Western District of Virginia                                |
| 1942 | Western District of Washington                              |
| 1943 | Western District of Wisconsin                               |
| 1946 | Supreme Court of the United States                          |
| 1947 | U.S. Court of Appeals for Veterans Claims                   |
| 1948 | Foreign Intelligence Surveillance Court                     |
| 1949 | Foreign Intelligence Surveillance Court of Review           |
| 1950 | District Court for the Northern Mariana Islands             |
| 1951 | District Court of the Virgin Islands                        |
| 1952 | District Court of Guam                                      |
| 1956 | No Court                                                    |
| 1957 | Puerto Rico state trial court                               |
| 1958 | Puerto Rico state appellate court                           |
| 1959 | Puerto Rico state supreme court                             |
| 1960 | Utah state trial court                                      |
| 1961 | Utah state appellate court                                  |
| 1962 | Utah state supreme court                                    |
| 1963 | Virginia state trial court                                  |
| 1964 | Virginia state appellate court                              |
| 1965 | Virginia state supreme court                                |
| 1966 | Vermont state trial court                                   |
| 1967 | Vermont state appellate court                               |
| 1968 | Vermont state supreme court                                 |
| 1969 | Wisconsin state trial court                                 |
| 1970 | Wisconsin state appellate court                             |
| 1971 | Wisconsin state supreme court                               |
| 1972 | Alaska state trial court                                    |
| 1973 | Alaska state appellate court                                |
| 1974 | Alaska state supreme court                                  |
| 1975 | Alabama state trial court                                   |
| 1976 | Alabama state appellate court                               |
| 1977 | Alabama state supreme court                                 |
| 1978 | Arkansas state trial court                                  |
| 1979 | Arkansas state appellate court                              |
| 1980 | Arkansas state supreme court                                |
| 1981 | American Samoa state trial court                            |
| 1982 | American Samoa state appellate court                        |
| 1983 | American Samoa state supreme court                          |
| 1984 | Arizona state trial court                                   |
| 1985 | Arizona state appellate court                               |
| 1986 | Arizona state supreme court                                 |
| 1987 | California state trial court                                |
| 1988 | California state appellate court                            |
| 1989 | California state supreme court                              |
| 1990 | Colorado state trial court                                  |
| 1991 | Colorado state appellate court                              |
| 1992 | Colorado state supreme court                                |
| 1993 | Connecticut state trial court                               |
| 1994 | Connecticut state appellate court                           |
| 1995 | Connecticut state supreme court                             |
| 1996 | District of Columbia state trial court                      |
| 1997 | District of Columbia state appellate court                  |
| 1998 | District of Columbia state supreme court                    |
| 1999 | Delaware state trial court                                  |
| 2000 | Delaware state appellate court                              |
| 2001 | Delaware state supreme court                                |
| 2002 | Florida state trial court                                   |
| 2003 | Florida state appellate court                               |
| 2004 | Florida state supreme court                                 |
| 2005 | West Virginia state trial court                             |
| 2006 | West Virginia state appellate court                         |
| 2007 | West Virginia state supreme court                           |
| 2008 | Wyoming state trial court                                   |
| 2009 | Wyoming state appellate court                               |
| 2010 | Wyoming state supreme court                                 |
| 2020 | Guam state trial court                                      |
| 2021 | Guam state appellate court                                  |
| 2022 | Guam state supreme court                                    |
| 2023 | Hawaii state trial court                                    |
| 2024 | Hawaii state appellate court                                |
| 2025 | Hawaii state supreme court                                  |
| 2026 | Iowa state trial court                                      |
| 2027 | Iowa state appellate court                                  |
| 2028 | Iowa state supreme court                                    |
| 2029 | Idaho state trial court                                     |
| 2030 | Idaho state appellate court                                 |
| 2031 | Idaho state supreme court                                   |
| 2032 | Illinois state trial court                                  |
| 2033 | Illinois state appellate court                              |
| 2034 | Illinois state supreme court                                |
| 2035 | Indiana state trial court                                   |
| 2036 | Indiana state appellate court                               |
| 2037 | Indiana state supreme court                                 |
| 2038 | Kansas state trial court                                    |
| 2039 | Kansas state appellate court                                |
| 2040 | Kansas state supreme court                                  |
| 2041 | Kentucky state trial court                                  |
| 2042 | Kentucky state appellate court                              |
| 2043 | Kentucky state supreme court                                |
| 2044 | Louisiana state trial court                                 |
| 2045 | Louisiana state appellate court                             |
| 2046 | Louisiana state supreme court                               |
| 2047 | Massachusetts state trial court                             |
| 2048 | Massachusetts state appellate court                         |
| 2049 | Massachusetts state supreme court                           |
| 2050 | Maryland state trial court                                  |
| 2051 | Maryland state appellate court                              |
| 2052 | Maryland state supreme court                                |
| 2053 | Maine state trial court                                     |
| 2054 | Maine state appellate court                                 |
| 2055 | Maine state supreme court                                   |
| 2056 | Marshall Islands state trial court                          |
| 2057 | Marshall Islands state appellate court                      |
| 2058 | Marshall Islands state supreme court                        |
| 2059 | Michigan state trial court                                  |
| 2060 | Michigan state appellate court                              |
| 2061 | Michigan state supreme court                                |
| 2062 | Minnesota state trial court                                 |
| 2063 | Minnesota state appellate court                             |
| 2064 | Minnesota state supreme court                               |
| 2065 | Missouri state trial court                                  |
| 2066 | Missouri state appellate court                              |
| 2067 | Missouri state supreme court                                |
| 2068 | Northern Mariana Islands state trial court                  |
| 2069 | Northern Mariana Islands state appellate court              |
| 2070 | Northern Mariana Islands state supreme court                |
| 2071 | Mississippi state trial court                               |
| 2072 | Mississippi state appellate court                           |
| 2073 | Mississippi state supreme court                             |
| 2074 | Montana state trial court                                   |
| 2075 | Montana state appellate court                               |
| 2076 | Montana state supreme court                                 |
| 2077 | North Carolina state trial court                            |
| 2078 | North Carolina state appellate court                        |
| 2079 | North Carolina state supreme court                          |
| 2080 | North Dakota state trial court                              |
| 2081 | North Dakota state appellate court                          |
| 2082 | North Dakota state supreme court                            |
| 2083 | Nebraska state trial court                                  |
| 2084 | Nebraska state appellate court                              |
| 2085 | Nebraska state supreme court                                |
| 2086 | New Hampshire state trial court                             |
| 2087 | New Hampshire state appellate court                         |
| 2088 | New Hampshire state supreme court                           |
| 2089 | New Jersey state trial court                                |
| 2090 | New Jersey state appellate court                            |
| 2091 | New Jersey state supreme court                              |
| 2092 | New Mexico state trial court                                |
| 2093 | New Mexico state appellate court                            |
| 2094 | New Mexico state supreme court                              |
| 2095 | Nevada state trial court                                    |
| 2096 | Nevada state appellate court                                |
| 2097 | Nevada state supreme court                                  |
| 2098 | New York state trial court                                  |
| 2099 | New York state appellate court                              |
| 2100 | New York state supreme court                                |
| 2101 | Ohio state trial court                                      |
| 2102 | Ohio state appellate court                                  |
| 2103 | Ohio state supreme court                                    |
| 2104 | Oklahoma state trial court                                  |
| 2105 | Oklahoma state appellate court                              |
| 2106 | Oklahoma state supreme court                                |
| 2107 | Oregon state trial court                                    |
| 2108 | Oregon state appellate court                                |
| 2109 | Oregon state supreme court                                  |
| 2110 | Pennsylvania state trial court                              |
| 2111 | Pennsylvania state appellate court                          |
| 2112 | Pennsylvania state supreme court                            |
| 2113 | Palau state trial court                                     |
| 2114 | Palau state appellate court                                 |
| 2115 | Palau state supreme court                                   |
| 2116 | Rhode Island state trial court                              |
| 2117 | Rhode Island state appellate court                          |
| 2118 | Rhode Island state supreme court                            |
| 2119 | South Carolina state trial court                            |
| 2120 | South Carolina state appellate court                        |
| 2121 | South Carolina state supreme court                          |
| 2122 | South Dakota state trial court                              |
| 2123 | South Dakota state appellate court                          |
| 2124 | South Dakota state supreme court                            |
| 2125 | Tennessee state trial court                                 |
| 2126 | Tennessee state appellate court                             |
| 2127 | Tennessee state supreme court                               |
| 2128 | Texas state trial court                                     |
| 2129 | Texas state appellate court                                 |
| 2130 | Texas state supreme court                                   |
| 2131 | Virgin Islands state trial court                            |
| 2132 | Virgin Islands state appellate court                        |
| 2133 | Virgin Islands state supreme court                          |
| 2134 | Washington state trial court                                |
| 2135 | Washington state appellate court                            |
| 2136 | Washington state supreme court                              |
| 2137 | Georgia state trial court                                   |
| 2138 | Georgia state appellate court                               |
| 2139 | Georgia state supreme court                                 |
| 2140 | Federated States of Micronesia state trial court            |
| 2141 | Federated States of Micronesia state appellate court        |
| 2142 | Federated States of Micronesia state supreme court          |
| 2143 | U.S. Judicial Panel on Multidistrict Litigation (JPML)      |

For more information about courts, see [Case Details](/api-reference-v2p1/objects/case/case-details#court).

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

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

```
https://clearinghouse.net/api/v2p1/cases?court=1828
```

{% endtab %}

{% tab title="Untitled" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Court Level Summary

Filter cases by court level summary.

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

## Filter by court level summary (integer).

### Query Parameters

| Name                  | Type    | Description                                                                        |
| --------------------- | ------- | ---------------------------------------------------------------------------------- |
| court\_level\_summary | Integer | Court level summary id (see list below for list of integers and its mapped values) |

#### Supported values

| Id    | Name     |
| ----- | -------- |
| 39157 | Federal  |
| 39158 | State    |
| 39159 | No court |

#### 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> |

## Example

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

```
https://clearinghouse.net/api/v2p1/cases?court_level_summary=39158
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Status

Filter cases by case status

## Filter by case status (integer).

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

#### Query Parameters

| Name                                           | Type    | Description                                                                |
| ---------------------------------------------- | ------- | -------------------------------------------------------------------------- |
| case\_status<mark style="color:red;">\*</mark> | integer | case status id (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 case status (case\_status\_id):

| 5071 | Coding Complete     |
| ---- | ------------------- |
| 5069 | Approved            |
| 5074 | In Process (Public) |

For more information about case statuses, see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

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

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

```
https://clearinghouse.net/api/v2p1/cases?case_status=5071
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Plaintiffs


# Public Interest Lawyer

Filter cases by public interest lawyer status

## Filter by public interest value (int).

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

#### Query Parameters

| Name                                                 | Type    | Description                                                                  |
| ---------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| relief\_source\_id<mark style="color:red;">\*</mark> | integer | Relief source ID (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 public interest lawyer IDs (public\_interest\_lawyer\_id):

| 5802 | No      |
| ---- | ------- |
| 5801 | Yes     |
| 5803 | Unknown |

For more information about public interest lawyer status, see [Parties](/api-reference-v2p1/objects/case/parties#public_interest_lawyer).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?public_interest_lawyer=5803
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Pro Se Status

Filter cases by filed pro se status

## Filter by pro se status id (int).

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

#### Query Parameters

| Name                                                 | Type    | Description                                                                  |
| ---------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| relief\_source\_id<mark style="color:red;">\*</mark> | integer | Relief source ID (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 pro se status IDs (pro\_se\_status\_id):

| 5025 | No      |
| ---- | ------- |
| 5027 | Unknown |
| 5026 | Yes     |

For more about pro se status, see [Parties](/api-reference-v2p1/objects/case/parties#pro_se_status).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?pro_se_status=5027
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Class Action Sought

Filter cases by class action sought status

## Filter by class action sought id (int).

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

#### Query Parameters

| Name                                                 | Type    | Description                                                                  |
| ---------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| relief\_source\_id<mark style="color:red;">\*</mark> | integer | Relief source ID (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 class action sought IDs (class\_action\_sought\_id):

| 5018 | Yes     |
| ---- | ------- |
| 5019 | Unknown |
| 5017 | No      |

For more about class action sought status, see [Parties](/api-reference-v2p1/objects/case/parties#class_action_sought).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?class_action_sought=5019
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Class Action Granted

Filter cases by class action outcome

## Filter by class action granted ID (integer).

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

#### Query Parameters

| Name                                                         | Type    | Description                                                                                                                                                    |
| ------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| class\_action\_granted\_id<mark style="color:red;">\*</mark> | integer | Class action granted variable ID (see [Parties](/api-reference-v2p1/objects/case/parties#class_action_granted) for the 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> |

For more about class action outcomes, see [Parties](/api-reference-v2p1/objects/case/parties#class_action_granted).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?class_action_granted=5014
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Attorney Organization

Filter cases by attorney organization

## Filter by case attorney organization (integer).

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

#### Query Parameters

| Name                                                | Type    | Description                                                                          |
| --------------------------------------------------- | ------- | ------------------------------------------------------------------------------------ |
| attorney\_org\_id<mark style="color:red;">\*</mark> | integer | Attorney organization ID (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 attorney orgs (attorney\_org\_id):

| **38491** | Perkins Coie                                       |
| --------- | -------------------------------------------------- |
| **5725**  | California Rural Legal Assistance                  |
| **38501** | Abolitionist Law Center                            |
| **5777**  | ACLU Immigrants' Rights Project                    |
| **5742**  | National Women's Law Center                        |
| **38503** | Pennsylvania Institutional Law Project             |
| **5712**  | Southern Center for Human Rights (SCHR)            |
| **5710**  | Civil Rights Education and Enforcement Center      |
| **5706**  | ACLU of Southern California                        |
| **5704**  | ACLU National (all projects)                       |
| **5703**  | NYU Clinical Law Center                            |
| **5708**  | ACLU of Michigan                                   |
| **5709**  | Center for Constitutional Rights (CCR)             |
| **5744**  | Prisoners' Legal Services of Massachusetts         |
| **5716**  | Lawyers Comm. for Civil Rights Under Law           |
| **5711**  | Prison Law Office                                  |
| **5731**  | Kairys, Rudovsky, Messing & Feinberg, LLP          |
| **5733**  | Public Justice                                     |
| **5729**  | Public Counsel                                     |
| **5727**  | American Immigration Lawyers Association (AILA)    |
| **5730**  | Asian American Legal Defense & Educ. Fund (AALDEF) |
| **5728**  | National Day Laborer Organizing Network (NDLON)    |
| **5762**  | Uptown People's Law Center                         |
| **5756**  | Appleseed                                          |
| **5752**  | ACLU National Prison Project                       |
| **5745**  | University of Denver Civil Rights Clinic           |
| **5735**  | Advancement Project                                |
| **5766**  | National Center for Youth Law                      |
| **5760**  | ACLU Affiliates (any)                              |
| **5755**  | U.S. Dept. of Justice Civil Rights Division        |
| **5763**  | Bazelon Center                                     |
| **5767**  | Lambda Legal                                       |
| **5764**  | Children's Rights, Inc.                            |
| **5765**  | MALDEF                                             |
| **5758**  | NAACP Legal Defense Fund                           |
| **5773**  | Emery Celli Brinckerhoff & Abady LLP               |
| **5770**  | Steve Gold                                         |
| **5771**  | Equal Justice Under Law                            |
| **5776**  | National Immigration Law Center                    |
| **5774**  | Equal Justice Initiative (EJI)                     |
| **5772**  | Relman, Dane & Colfax                              |
| **5779**  | ACLU of Northern California                        |
| **5784**  | Human Rights First                                 |
| **5782**  | Public Interest Law Center (PILCOP)                |
| **5789**  | Bronx Defenders                                    |
| **5790**  | Earthjustice                                       |
| **5788**  | Florida Justice Institute                          |
| **5786**  | International Refugee Assistance Project (IRAP)    |
| **5785**  | Juvenile Law Center                                |
| **5791**  | New York Civil Liberties Union (NYCLU)             |
| **5724**  | Americans for Immigrant Justice (previously FIAC)  |
| **5734**  | ArchCity Defenders                                 |
| **5721**  | Kaye, McLane, Bednarski & Litt                     |
| **5736**  | Asian Americans Advancing Justice \| AAJC          |
| **5722**  | LatinoJustice PRLDEF                               |
| **5768**  | GLAD (GLBTQ Legal Advocates & Defenders)           |
| **5780**  | Northwest Immigrant Rights Project (NWIRP)         |
| **5769**  | Youth Law Center                                   |
| **5743**  | Institute for Justice                              |
| **5792**  | National Immigration Project of the NLG            |
| **5783**  | Outten & Golden                                    |
| **5714**  | Loevy & Loevy                                      |
| **5757**  | Southern Poverty Law Center                        |
| **11011** | Center for Reproductive Rights                     |
| **11012** | Planned Parenthood Federation of America           |
| **5775**  | Civil Rights Corps                                 |
| **5726**  | Columbia Legal Services (formerly Evergreen)       |
| **5787**  | Council on American-Islamic Relations (CAIR)       |
| **5723**  | Farmworker Justice                                 |
| **5713**  | Hadsell, Stormer & Renick                          |
| **5707**  | Impact Fund                                        |
| **5759**  | Law Office of Lainey Feingold                      |
| **5719**  | Jerome N. Frank Legal Services Organization (Yale) |
| **5754**  | Legal Services/Legal Aid                           |
| **5739**  | MacArthur Justice Center                           |
| **5746**  | Prisoners' Legal Services of New York (PLSNY)      |
| **5720**  | Rosen, Bien, Galvan & Grunfeld                     |
| **5737**  | Brennan Center for Justice                         |
| **5738**  | Disability Rights Education & Defense Fund (DREDF) |
| **5753**  | EEOC                                               |
| **5781**  | American Immigration Council's Legal Action Center |
| **5740**  | Muslim Advocates                                   |
| **5778**  | Center for Human Rights & Constitutional Law       |
| **5717**  | National Center for Lesbian Rights (NCLR)          |
| **5761**  | Prisoners Rights Union                             |
| **5718**  | Washington Lawyers' Committee                      |
| **5705**  | Michigan Clinical Law Program                      |
| **5715**  | NDRN/Protection & Advocacy Organizations           |

For more about attorney organizations, see [Parties](/api-reference-v2p1/objects/case/parties#attorney_orgs).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?attorney_orgs=5715
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Plaintiff Type

Filter cases by plaintiff type

## Filter by plaintiff type ID (integer).

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

#### Query Parameters

| Name                                              | Type    | Description                                                                   |
| ------------------------------------------------- | ------- | ----------------------------------------------------------------------------- |
| plaintiff\_type<mark style="color:red;">\*</mark> | integer | Plaintiff Type ID (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 plaintiff type IDs (plaintiff\_type\_id):

| 5579 | Non-profit religious organization     |
| ---- | ------------------------------------- |
| 5290 | City/County Plaintiff                 |
| 5577 | Public (for-profit) corporation       |
| 5372 | American Indian Tribe                 |
| 5452 | EEOC Plaintiff                        |
| 5451 | Private Plaintiff                     |
| 5455 | State Plaintiff                       |
| 5578 | Closely-held (for profit) corporation |
| 5584 | Non-DOJ federal government plaintiff  |
| 5454 | U.S. Dept of Justice plaintiff        |
| 5580 | Non-profit NON-religious organization |

For more about plaintiff types, see [Issues](/api-reference-v2p1/objects/case/issues#plaintiff-type).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?plaintiff_type=5580
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Defendants


# Defendant Type

Filter cases by defendant type

## Filter by defendant type ID (integer).

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

#### Query Parameters

| Name                                              | Type    | Description                                                                   |
| ------------------------------------------------- | ------- | ----------------------------------------------------------------------------- |
| defendant\_type<mark style="color:red;">\*</mark> | integer | Defendant Type ID (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 defendant type IDs (defendant\_type\_id):

| 5283 | Housing Authority                             |
| ---- | --------------------------------------------- |
| 5284 | Law-enforcement                               |
| 5289 | Jurisdiction-wide                             |
| 5324 | Insurer                                       |
| 5321 | Multi-family housing provider                 |
| 5323 | Bank or credit provider                       |
| 5505 | Elementary/Secondary School                   |
| 5503 | College/University                            |
| 5504 | Corrections                                   |
| 5563 | Movie Theater or Other Entertainment facility |
| 5561 | Restaurant                                    |
| 5287 | Sanitation/Public Works                       |
| 5288 | Transportation                                |
| 5506 | Fire                                          |
| 5507 | Hospital/Health Department                    |
| 5285 | Parks                                         |
| 5286 | Retailer                                      |
| 5322 | Single family housing provider                |

For more information about defendant types, see [Issues](/api-reference-v2p1/objects/case/issues#defendant-type).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?defendant_type=5561
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Defendant Level

Filter cases by defendant level

## Filter by defendant level ID (integer).

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

#### Query Parameters

| Name                                               | Type    | Description                                                                    |
| -------------------------------------------------- | ------- | ------------------------------------------------------------------------------ |
| defendant\_level<mark style="color:red;">\*</mark> | integer | Defendent level ID (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" %}

```javascript
\\ 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 %}

This will filter cases that contain a defendant with the queried defendant level.

Supported defendant level IDs (defendant\_level\_id):

| 6149 | Federal                |
| ---- | ---------------------- |
| 6147 | City                   |
| 6148 | County                 |
| 6156 | Non-profit or advocacy |
| 6151 | Political Party        |
| 6150 | Private Entity/Person  |
| 6154 | Regional               |
| 6152 | School District        |
| 6146 | State                  |
| 6153 | Tribe                  |
| 6155 | Union                  |

For more information about defendant levels, see [Defendant](/api-reference-v2p1/objects/defendant#defendant_level).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?defendant_level=6147
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Facility type

Filter cases by facility type

## Filter by defendant level ID (integer).

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

#### Query Parameters

| Name                                             | Type    | Description                                                                  |
| ------------------------------------------------ | ------- | ---------------------------------------------------------------------------- |
| facility\_type<mark style="color:red;">\*</mark> | integer | Facility type ID (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 facility type IDs (facility\_type\_id):

| 5431 | Non-government for-profit |
| ---- | ------------------------- |
| 5430 | Non-government non-profit |
| 5429 | Government-run            |

For more information about facility types, see [Issues](/api-reference-v2p1/objects/case/issues#type-of-facility).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?facility_type=5431
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Details


# Cause of Action

Filter cases by cause of action

## Filter by one or more cause of action IDs (integers).

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

#### Query Parameters

| Name                                     | Type    | Description                                                           |
| ---------------------------------------- | ------- | --------------------------------------------------------------------- |
| causes<mark style="color:red;">\*</mark> | integer | case type (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 Case 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 cause of actions (cause\_of\_action\_id):

| **5078** | 2 U.S.C. § 437                                                                                                        |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| **5079** | 28 U.S.C. § 1441                                                                                                      |
| **5080** | Federal Campaign Finance law, 2 U.S.C. §§ 431 et seq.                                                                 |
| **5081** | TANF Block Grants, 42 U.S.C. § 601 et seq.                                                                            |
| **5082** | Uniformed and Overseas Citizens Absentia Voting Act, 52 U.S.C. § 20301 (previously 42 U.S.C. § 1973ff et seq.)        |
| **5083** | National Voter Registration Act ("Motor Voter law"), 52 U.S.C. § 20501 (previously 42 U.S.C. § 1973gg)                |
| **5084** | Voting Rights Act, section 208 (assistance for disabled persons), 52 U.S.C. § 10508 (previously 42 U.S.C. § 1973aa-6) |
| **5085** | 42 U.S.C. § 1983                                                                                                      |
| **5086** | Civil Rights of Institutionalized Persons Act (CRIPA), 42 U.S.C. § 1997 et seq.                                       |
| **5087** | Americans with Disabilities Act (ADA), 42 U.S.C. §§ 12111 et seq.                                                     |
| **5088** | Religious Freedom Rest. Act/Religious Land Use and Inst. Persons Act (RFRA/RLUIPA)                                    |
| **5089** | Ex Parte Young (Federal) or Bivens                                                                                    |
| **5090** | 42 U.S.C. § 1983                                                                                                      |
| **5091** | 42 U.S.C. § 1981                                                                                                      |
| **5092** | Civil Rights Act of 1957/1960, 52 U.S.C. § 10101 (previously 42 U.S.C. § 1971)                                        |
| **5093** | Voting Rights Act, section 2, 52 U.S.C. § 10301 (previously 42 U.S.C. § 1973)                                         |
| **5094** | 42 U.S.C. § 12112                                                                                                     |
| **5095** | 28 U.S.C. § 1331                                                                                                      |
| **5096** | 28 U.S.C. § 1343                                                                                                      |
| **5097** | 28 U.S.C. § 2201                                                                                                      |
| **5098** | Voting Rights Act, section 203 (language minority provision), 52 U.S.C. § 10503 (previously 42 U.S.C. § 1973aa-1a)    |
| **5099** | Voting Rights Act Sec. 2                                                                                              |
| **5100** | Help America Vote Act (HAVA), 52 U.S.C. § 20901 et seq (previously 42 U.S.C. § 15301 et seq)                          |
| **5101** | Adoption Assistance and Child Welfare Act of 1980 (AACWA), 42 U.S.C. §§ 620 et seq.                                   |
| **5102** | Adoption Assistance Program, 42 U.S.C. §§ 670 et seq.                                                                 |
| **5103** | Olmstead v. L.C.                                                                                                      |
| **5104** | Child Abuse Prevention and Treatment Act, 42 U.S.C. §§ 5101 et seq.                                                   |
| **5105** | Employee Retirement Income Security Act (ERISA), 29 U.S.C. § 1001                                                     |
| **5106** | Fair Housing Act/Fair Housing Amendments Act (FHAA), 42 U.S.C. §§ 3601 et seq.                                        |
| **5107** | False Claims Act, 31 U.S.C. § 3729                                                                                    |
| **5108** | Individuals w/ Disabilities Education Act (IDEA), Education of All Handicapped Children Act, 20 U.S.C. § 1400         |
| **5109** | Juvenile Justice Act, 42 U.S.C. § 5672                                                                                |
| **5110** | Medicaid Act, 42 U.S.C. § 1385a(a)(a)(30)(A)                                                                          |
| **5111** | Nursing Care Reform Act of 1987/Omnibus Reconciliation Act                                                            |
| **5112** | Section 504 (Rehabilitation Act), 29 U.S.C. § 701                                                                     |
| **5113** | Social Security (Title XX), 42 U.S.C. §§ 1397 et seq.                                                                 |
| **5114** | Voting Rights Act section 203 (language minority provisions), 42 U.S.C. § 1973aa-1a                                   |
| **5115** | Voting Rights Act, section 5, 52 U.S.C. § 10304 (previously 42 U.S.C. § 1973c)                                        |
| **5116** | Administrative Procedure Act, 5 U.S.C. §§ 551 et seq.                                                                 |
| **5117** | Voting Accessibility law, 52 U.S.C. § 20102 (previously 42 U.S.C. §§ 1973ee et seq.)                                  |
| **5118** | State law                                                                                                             |
| **5119** | Criminal Conspiracy to Violate Federal Rights, 18 U.S.C. § 241                                                        |
| **5120** | Criminal Violation of Federal Rights Under Color of Law, 18 U.S.C. § 242                                              |
| **5121** | 42 U.S.C. § 1985                                                                                                      |
| **5122** | 34 U.S.C. § 12601 (previously 42 U.S.C. § 14141)                                                                      |
| **5123** | Voting Rights Act, unspecified, 52 U.S.C. § 10301 et seq (previously 42 U.S.C § 1973 et seq.)                         |
| **5124** | 42 U.S.C. § 1982                                                                                                      |
| **5125** | Equal Credit Opportunity Act (ECOA), 15 U.S.C. § 1691                                                                 |
| **5126** | Community Reinvestment Act, 12 U.S.C. § 2901                                                                          |
| **5127** | Age Discrimination in Employment Act (ADEA), 29 U.S.C. §§ 621 et seq.                                                 |
| **5128** | Equal Pay Act, 29 U.S.C. § 206(d)                                                                                     |
| **5129** | Title VII (including PDA), 42 U.S.C. § 2000e                                                                          |
| **5130** | Uniformed Services Employment and Reemployment Rights Act (USERRA), 38 U.S.C. § 4301                                  |
| **5131** | Immigration and Nationality Act (INA), 8 U.S.C. §§ 1101 et seq.                                                       |
| **5132** | Illegal Immigration Reform and Immigrant Responsibility Act of 1996 (IIRIRA)                                          |
| **5133** | Racketeer Influenced and Corrupt Organizations Act (RICO), 18 U.S.C. §§ 1961 et seq.                                  |
| **5134** | Migrant and Seasonal Agricultural Workers Protection Act, 29 U.S.C. §§ 1801-1871                                      |
| **5135** | Fair Labor Standards Act (FLSA), 29 U.S.C. §§ 201-219                                                                 |
| **5136** | Habeas Corpus, 28 U.S.C. §§ 2241-2253; 2254; 2255                                                                     |
| **5137** | Declaratory Judgment Act, 28 U.S.C. § 2201                                                                            |
| **5138** | Mandamus, 28 U.S.C. § 1361                                                                                            |
| **5139** | All Writs Act, 28 U.S.C. § 1651                                                                                       |
| **5140** | Freedom of Information Act (FOIA), 5 U.S.C. § 552                                                                     |
| **5141** | Federal Tort Claims Act (FTCA), 28 U.S.C. § 2674                                                                      |
| **5142** | Alien Tort Claims Act (ATCA), 28 U.S.C. §§ 1350                                                                       |
| **5143** | Title VI, Civil Rights Act of 1964, 42 U.S.C. § 2000d et seq.                                                         |
| **5144** | National Labor Relations Act                                                                                          |
| **5145** | Immigration Reform and Control Act of 1986 (IRCA)                                                                     |
| **5146** | State Anti-Discrimination Law                                                                                         |
| **5147** | Medicaid, 42 U.S.C §1396 (Title XIX of the Social Security Act)                                                       |
| **5148** | Title IX of the Education Amendments of 1972, 20 U.S.C. §§ 1681 et seq.                                               |
| **5149** | Developmental Disabilities Assistance and Bill of Rights Act, 42 U.S.C. § 15001 et seq.                               |
| **5150** | FISA Title I Warrant (Electronic Surveillance), 50 U.S.C. §§ 1801-1812                                                |
| **5151** | FISA Title III Warrant (Physical Search), 50 U.S.C. §§ 1821-1829                                                      |
| **5152** | FISA Title IV order (pen register/trap-and-trace), 50 U.S.C. §§ 1841-1846                                             |
| **5153** | FISA Title V order (PATRIOT Act § 215, business records or other tangible things), 50 U.S.C. §§ 1861-1862             |
| **5154** | FISA Title VII targeting order (Sections 702, 703, 704), 50 U.S.C. 1881a, 1881b, 1881c                                |
| **5155** | Title IV, Civil Rights Act of 1964, 42 U.S.C. § 2000c et seq.                                                         |
| **5156** | Protection and Advocacy for Individuals with Mental Illness (PAIMI) Act, 42 U.S.C. § 10801                            |
| **5157** | Protection and Advocacy of Individual Rights (PAIR), 29 U.S.C. § 794e                                                 |
| **5158** | Ex parte Young (federal or state officials)                                                                           |
| **5159** | Fair Credit Reporting Act, 15 U.S.C. § 1681 ("FCRA")                                                                  |
| **5160** | Trafficking Victims Protection Act (TVPA), 18 U.S.C. § 1589                                                           |
| **5161** | National Environmental Protection Act, 42 U.S.C. §§ 4321–4370f                                                        |
| **5162** | Endangered Species Act, 16 U.S.C. § 1531 et seq.                                                                      |
| **5163** | Clean Water Act (CWA), 33 U.S.C. § 1319 et seq.                                                                       |
| **5164** | Resource Conservation and Recovery Act (RCRA), 42 U.S.C. § 6928 et seq.                                               |
| **5165** | Medicare, 42 U.S.C. § 1395-1395lll (Title XVIII of the Social Security Act)                                           |

For more information about causes of action, see [Causes of Action](/api-reference-v2p1/objects/case/causes-of-action#causes).

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

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

```
https://clearinghouse.net/api/v2p1/cases?causes=5143
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Available Documents

Filter cases by available documents

## Filter by available documents (integer).

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

#### Query Parameters

| Name                                                       | Type    | Description                                                                     |
| ---------------------------------------------------------- | ------- | ------------------------------------------------------------------------------- |
| available\_documents\_id<mark style="color:red;">\*</mark> | integer | cvailable documents (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 Case 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 available documents (available\_documents\_id):

| 5794 | Complaint (any)                        |
| ---- | -------------------------------------- |
| 5793 | Trial Court Docket                     |
| 5799 | U.S. Supreme Court merits opinion      |
| 5800 | None of the above                      |
| 5795 | Monetary Relief                        |
| 5796 | Injunctive (or Injunctive-like) Relief |
| 5798 | Any published opinion                  |
| 5797 | Non-settlement Outcome                 |

For more information about these types of documents, see [Documents](/api-reference-v2p1/objects/case/documents#available_documents).

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

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

```
https://clearinghouse.net/api/v2p1/cases?available_documents=5797
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Constitutional Clause

Filter cases by constitutional clause

## Filter by constitutional clause (constitutional\_clause\_id).

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

#### Query Parameters

| Name                                                     | Type    | Description                                                                       |
| -------------------------------------------------------- | ------- | --------------------------------------------------------------------------------- |
| constitutional\_clause<mark style="color:red;">\*</mark> | integer | constitutional clause (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 Case 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 constitutional clause IDs (constitutional\_clause\_id):

| 5335  | Commerce Power                        |
| ----- | ------------------------------------- |
| 5314  | Due Process                           |
| 5315  | Ex Post Facto                         |
| 5317  | Self-incrimination                    |
| 5316  | Right to travel                       |
| 5336  | Full faith and credit                 |
| 5364  | Suspension Clause                     |
| 5363  | Due Process: Substantive Due Process  |
| 5347  | Excessive bail/fines                  |
| 5348  | Slavery/Involuntary servitude         |
| 5361  | Petitions clause                      |
| 5571  | Cruel and Unusual Punishment          |
| 5537  | Equal Protection                      |
| 5598  | Emoluments Clauses                    |
| 5587  | Takings                               |
| 5581  | Supremacy Clause                      |
| 5373  | Enumerations Clause                   |
| 5362  | Due Process: Procedural Due Process   |
| 38546 | Fifteenth Amendment                   |
| 5510  | Establishment Clause                  |
| 5475  | Federalism (including 10th Amendment) |
| 5511  | Freedom of speech/association         |
| 5509  | Free Exercise Clause                  |
| 5445  | Unreasonable search and seizure       |

For more information about constitutional clauses, see [Issues](/api-reference-v2p1/objects/case/issues#constitutional-clause).

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

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

```
https://clearinghouse.net/api/v2p1/cases?constitutional_clause=5510
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Special Case Type

Filter cases by special case type

## Filter by special case type (constitutional\_clause\_id).

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

#### Query Parameters

| Name                                                  | Type    | Description                                                                      |
| ----------------------------------------------------- | ------- | -------------------------------------------------------------------------------- |
| special\_case\_type<mark style="color:red;">\*</mark> | integer | Special case type ID (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 Case 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 constitutional clause IDs (special\_case\_type\_id):

| 5596 | Non-court arbitration/mediation  |
| ---- | -------------------------------- |
| 5597 | Warrant or subpoena application  |
| 5593 | Appellate Court is initial court |
| 5591 | Criminal                         |
| 5592 | Habeas                           |
| 5374 | Tribal Court                     |
| 5594 | Multi-District Litigation (MDL)  |
| 5595 | Out-of-court                     |

For more information about these special case types, see [Issues](/api-reference-v2p1/objects/case/issues#special-case-type).

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

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

```
https://clearinghouse.net/api/v2p1/cases?special_case_type=5595
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Outcome


# Case Settlement Agreement

Filter cases by settlement status

## Filter by case settlement agreement ID (integer).

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

#### Query Parameters

| Name                                                    | Type    | Description                                                                      |
| ------------------------------------------------------- | ------- | -------------------------------------------------------------------------------- |
| settlement\_agreement<mark style="color:red;">\*</mark> | integer | Settlement status ID (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="401 Permission denied" %}

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

{% endtab %}
{% endtabs %}

Supported settlement status (settlement\_agreement\_id):

| **5647** | Court Approved Settlement or Consent Decree |
| -------- | ------------------------------------------- |
| **5646** | Confession of Judgment                      |
| **5649** | Voluntary Dismissal                         |
| **5648** | Private Settlement Agreement                |
| **5650** | Conditional Dismissal                       |

For more information on these settlement statuses, see [Outcome](/api-reference-v2p1/objects/case/outcome#settlement_agreement).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?settlement_agreement=5650
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Relief Sources

Filter cases by relief source

## Filter by case relief sources (integer).

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

#### Query Parameters

| Name                                              | Type    | Description                                                                  |
| ------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| relief\_sources<mark style="color:red;">\*</mark> | integer | Relief source ID (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 relief source IDs (relief\_source\_id):

| **5645** | None       |
| -------- | ---------- |
| **5644** | None yet   |
| **5642** | Litigation |
| **5643** | Unknown    |
| **5641** | Settlement |

For more information about these sources of relief, see [Outcome](/api-reference-v2p1/objects/case/outcome#relief_sources).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?relief_sources=5643
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Relief Natures

Filter cases by relief nature

## Filter by case relief natures (integer).

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

#### Query Parameters

| Name                                              | Type    | Description                                                                  |
| ------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| relief\_natures<mark style="color:red;">\*</mark> | integer | Relief nature ID (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 relief natures (relief\_nature\_id):

| **5632** | Attorneys fees                                   |
| -------- | ------------------------------------------------ |
| **5638** | Criminal Conviction                              |
| **5635** | Document/information produced                    |
| **5631** | None yet                                         |
| **5636** | Damages                                          |
| **5634** | Warrant/Order allowing surveillance              |
| **5637** | Unknown                                          |
| **5640** | Declaratory Judgment                             |
| **5630** | None                                             |
| **5629** | Injunction / Injunctive-like Settlement          |
| **5639** | Habeas relief                                    |
| **5633** | Preliminary injunction / Temp. restraining order |

For more information about these natures of relief, see [Outcome](/api-reference-v2p1/objects/case/outcome#relief_natures).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?relief_natures=5635
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Content of Injunction

Filter cases by content of injunction

## Filter by case content of injunction (integer).

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

#### Query Parameters

| Name                                                      | Type    | Description                                                                          |
| --------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------ |
| content\_of\_injunction<mark style="color:red;">\*</mark> | integer | Content of Injunction ID (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 %}

| 5573  | Warrant/order for search or seizure                       |
| ----- | --------------------------------------------------------- |
| 5574  | Required disclosure                                       |
| 5523  | Expungement of Employment Record                          |
| 38547 | New Election                                              |
| 5527  | Discrimination Prohibition                                |
| 38548 | Redistricting                                             |
| 38549 | Vote Counting                                             |
| 38550 | Voting Process Changes                                    |
| 38551 | Voter Registration                                        |
| 38552 | State Statute Struck Down                                 |
| 5542  | Auditing                                                  |
| 5342  | Busing                                                    |
| 5533  | Comply with advertising/recruiting requirements           |
| 5529  | Develop anti-discrimination policy                        |
| 5532  | Follow recruitment, hiring, or promotion protocols        |
| 5544  | Goals (e.g., for hiring, admissions)                      |
| 5519  | Hire                                                      |
| 5538  | Implement complaint/dispute resolution process            |
| 5534  | Other requirements regarding hiring, promotion, retention |
| 5535  | Post/Distribute Notice of Rights / EE Law                 |
| 5540  | Monitor/Master                                            |
| 5330  | Preliminary relief granted                                |
| 5327  | Receivership                                              |
| 5628  | Preliminary relief request withdrawn/mooted               |
| 5520  | Promotion                                                 |
| 5536  | Provide antidiscrimination training                       |
| 5541  | Recordkeeping                                             |
| 5539  | Reporting                                                 |
| 5528  | Retaliation Prohibition                                   |
| 5525  | Retroactive Seniority                                     |
| 5343  | Student assignment                                        |
| 5585  | Training                                                  |
| 5531  | Utilize objective hiring/promotion criteria               |
| 5530  | Utilize objective job description                         |
| 5526  | Reasonable Accommodation                                  |
| 5522  | Reinstatement                                             |
| 5344  | Remedial education                                        |
| 5341  | Magnet school                                             |
| 5543  | Monitoring                                                |
| 5524  | Neutral/Positive Reference                                |
| 5521  | Position Restored                                         |
| 5331  | Preliminary relief denied                                 |
| 5518  | Apology                                                   |

For more information about these injunction criteria, see [Issues](/api-reference-v2p1/objects/case/issues#content-of-injunction).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?content_of_injunction=5331
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Prevailing Party

Filter cases by prevailing party

## Filter by case prevailing party (integer).

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

#### Query Parameters

| Name                                                | Type    | Description                                                                  |
| --------------------------------------------------- | ------- | ---------------------------------------------------------------------------- |
| prevailing\_party<mark style="color:red;">\*</mark> | integer | prevailing party (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 prevailing party (prevailing\_party\_id):

| 5029 | Mixed           |
| ---- | --------------- |
| 5032 | Plaintiff       |
| 5031 | Defendant       |
| 5028 | Unknown         |
| 5030 | None Yet / None |

For more information about a case's prevailing party, see [Outcome](/api-reference-v2p1/objects/case/outcome#prevailing_party).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?prevailing_party=5032
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Documents

## Get all documents associated with Case ID (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/18003/documents
```

{% endtab %}

{% tab title="python" %}

```
import requests

url = "https://clearinghouse.net/api/v2p1/cases/18003/documents"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}

## Get a single document by Document ID (integer).

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/documents/ID`

Returns the full document record for the given ID, including document text.

### **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 Document successfully retrieved" %}

{% endtab %}

{% tab title="400: Bad Request No results or invalid parameter" %}

```
\\ No results
\\ Example query endpoint: /api/v2p1/documents/1
["No results for {'id': '1'}"]

\\ Invalid parameter
\\ Example query endpoint: /api/v2p1/documents/xyz
["API Error: xyz is not an integer."]
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

### **Example**

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

```
https://clearinghouse.net/api/v2p1/documents/136285/
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Documents

### Get documents.

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/documents/`

Returns a paginated list of documents. All parameters are optional and can be combined.

**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> |

**Query Parameters**

| Parameter             | Type    | Description                                                                                                |
| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| case\_id              | Integer | Filter by case ID.                                                                                         |
| docket\_id            | Integer | Filter by docket ID.                                                                                       |
| title                 | String  | Case-insensitive partial match on document title.                                                          |
| is\_core\_document    | Boolean | Filter by core document status. Accepts `true` or `false`.                                                 |
| document\_type        | Integer | Filter by document type ID. See supported values below.                                                    |
| document\_status      | Integer | Filter by document status ID. See supported values below.                                                  |
| born\_digital\_status | Integer | Filter by born digital status ID. See supported values below.                                              |
| text                  | String  | Full-text search across document text, document title, case name, and case summary. See Text Search below. |

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

{% endtab %}

{% tab title="400: Bad Request No results, key not found, or invalid parameter" %}

```
\\ No results
\\ Example query endpoint: /api/v2p1/documents/?title=zzznomatch
["No results for {'title': 'zzznomatch'}"]

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

\\ Invalid parameter
\\ Example query endpoint: /api/v2p1/documents/?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 %}

**Example**

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

```
https://clearinghouse.net/api/v2p1/documents/?case_id=18003&document_type=5893
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/documents/?case_id=18003&document_type=5893"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}

***

#### Supported Filter Values

**document\_type**

| id    | value                                         |
| ----- | --------------------------------------------- |
| 5894  | Declaration/Affidavit                         |
| 5908  | Discovery Material/FOIA Release               |
| 5909  | Docket                                        |
| 5905  | Complaint                                     |
| 5906  | Correspondence                                |
| 38543 | Executive Order                               |
| 5899  | FOIA Request                                  |
| 5910  | Findings Letter/Report                        |
| 5897  | Internal memorandum                           |
| 5895  | Justification Memo                            |
| 5896  | Legislative Report                            |
| 5891  | Magistrate Report/Recommendation              |
| 5911  | Monitor/Expert/Receiver Report                |
| 5913  | Notice of Investigation or Suit/Demand Letter |
| 5893  | Order/Opinion                                 |
| 5914  | Other                                         |
| 5915  | Pleading / Motion / Brief                     |
| 5898  | Press Release                                 |
| 5900  | Settlement Agreement                          |
| 5892  | Statute/Ordinance/Regulation                  |
| 38762 | Statement of Interest (DOJ)                   |
| 5904  | Transcript                                    |

**document\_status**

| id   | value                                       |
| ---- | ------------------------------------------- |
| 5923 | Approved                                    |
| 5927 | Coding Complete                             |
| 5928 | Coding Complete, but not for Public Display |
| 5925 | Deleted                                     |
| 5926 | Empty/Missing Document                      |
| 5920 | In Process                                  |

**born\_digital\_status**

| id    | value        |
| ----- | ------------ |
| 39148 | Born digital |
| 39150 | Mixed        |
| 39149 | Scanned      |

***

#### Text Search

The `text` parameter uses PostgreSQL full-text search. It runs across the following fields, in descending order of relevance weight:

| Field          | Weight      |
| -------------- | ----------- |
| Case name      | A (highest) |
| Document title | B           |
| Case summary   | C           |
| Document text  | D (lowest)  |

Queries support natural language stemming (e.g. "running" matches "run"). Multi-word queries require all terms to match (AND logic).

**Example**

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

```
https://clearinghouse.net/api/v2p1/documents/?text=solitary+confinement
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/documents/?text=solitary+confinement"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}

***

### Get a single document by Document ID (integer).

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/documents/ID/`

Returns the full document record for the given ID, including document text.

**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 Document successfully retrieved" %}

{% endtab %}

{% tab title="400: Bad Request No results or invalid parameter" %}

```
\\ No results
\\ Example query endpoint: /api/v2p1/documents/1/
["No results for {'id': '1'}"]

\\ Invalid parameter
\\ Example query endpoint: /api/v2p1/documents/xyz/
["API Error: xyz is not an integer."]
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

**Example**

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

```
https://clearinghouse.net/api/v2p1/documents/136285/
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Dockets

## Get all dockets associated with Case ID (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/18003/dockets
```

{% endtab %}

{% tab title="python" %}

```
import requests

url = "https://clearinghouse.net/api/v2p1/cases/18003/dockets"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}

##


# Docket Office Number

## Get all dockets associated with office number (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/?docket_office_number=3
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket Filing Number

## Get all dockets associated with office number (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/?docket_filing_number=1067
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket Year

## Get all dockets associated with year (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/?docket_year=2025
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket

## Get all dockets associated with its ID (integer).

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/dockets/?id=docket_id`

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?id=61128
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket RECAP ID

## Get docket associated with recap\_id (integer).

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/dockets/?recap_id=id`

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?recap_id=72085714
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}

## Supported recap\_id (id):

You can also query a docket by its RECAP ID, which is a reference to the `id` field returned by the RECAP API at the docket endpoints (<https://www.courtlistener.com/api/rest/v4/dockets/>). For more details, see: <https://www.courtlistener.com/help/api/rest/>


# Docket Court

## Get all dockets associated with court ID (integer). See [Case Court](/api-reference-v2p1/endpoints/case-court) for `court_id` values.

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/dockets/?court_id=court`

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?court_id=1792
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket Year

## Get all dockets associated with its Docket Year (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?docket_year=2025
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket Filing Number

## Get all dockets associated with docket filing number (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?docket_filing_number=5067
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Docket Office Number

## Get all dockets associated with Docket Office Number (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/dockets/?docket_office_number=1
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Resources

## Get all resources associated with Case ID (integer).

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

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

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases/11085/resources
```

{% endtab %}

{% tab title="python" %}

```
import requests

url = "https://clearinghouse.net/api/v2p1/cases/11085/resources"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}

##


# Issues


# Case Issue

Filter cases by issue

## Filter by case issue (integer).

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

#### Query Parameters

| Name                                        | Type    | Description                                                          |
| ------------------------------------------- | ------- | -------------------------------------------------------------------- |
| issue\_id<mark style="color:red;">\*</mark> | integer | issue ID (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 issues (issue\_id):

| **5264**  | Aid to Families with Dependent Children (AFDC)                                                  |
| --------- | ----------------------------------------------------------------------------------------------- |
| **5266**  | Drivers Licenses                                                                                |
| **5579**  | Non-profit religious organization                                                               |
| **5573**  | Warrant/order for search or seizure                                                             |
| **5182**  | Food service / nutrition / hydration                                                            |
| **5166**  | Crowding / caseload                                                                             |
| **5169**  | Suicide prevention                                                                              |
| **5187**  | Phone                                                                                           |
| **5186**  | Mail                                                                                            |
| **5175**  | Disciplinary procedures                                                                         |
| **5190**  | Emergency shelter                                                                               |
| **5179**  | Search policies                                                                                 |
| **5178**  | Loss or damage to property                                                                      |
| **5181**  | Counseling                                                                                      |
| **5173**  | Protective custody                                                                              |
| **5180**  | Staff (number, training, qualifications, wages)                                                 |
| **5174**  | Disciplinary segregation                                                                        |
| **5200**  | Informed consent/involuntary medication                                                         |
| **5225**  | Dementia                                                                                        |
| **5220**  | Arab/Afgani/Middle Eastern                                                                      |
| **5203**  | Language access/needs                                                                           |
| **5205**  | Neglect by staff                                                                                |
| **5213**  | Racial segregation                                                                              |
| **5222**  | Other                                                                                           |
| **5207**  | Payment for care                                                                                |
| **5197**  | Housing assistance                                                                              |
| **5211**  | Poverty/homelessness                                                                            |
| **5206**  | Parents (visitation, involvement)                                                               |
| **5215**  | Record-keeping                                                                                  |
| **5210**  | Placement in shelters                                                                           |
| **5208**  | Placement in detention facilities                                                               |
| **5224**  | Bed care (including sores)                                                                      |
| **5216**  | Rehabilitation                                                                                  |
| **5214**  | Reassessment and care planning                                                                  |
| **5212**  | Public assistance grants                                                                        |
| **5209**  | Placement in mental health facilities                                                           |
| **5201**  | Integrated setting                                                                              |
| **5217**  | Relative caretakers                                                                             |
| **5218**  | Sexual abuse by residents/inmates                                                               |
| **5233**  | Mental health care, general                                                                     |
| **5250**  | Failure to supervise                                                                            |
| **5252**  | International law                                                                               |
| **5243**  | Strip search policy                                                                             |
| **5234**  | Intellectual disability/mental illness dual diagnosis                                           |
| **5256**  | Terrorism/Post 9-11 issues                                                                      |
| **5241**  | disability, unspecified                                                                         |
| **5242**  | Mental Illness, Unspecified                                                                     |
| **5230**  | Medical care, general                                                                           |
| **5232**  | Medication, administration of                                                                   |
| **5610**  | COVID testing ordered/modified                                                                  |
| **5239**  | Wound care                                                                                      |
| **5263**  | Adoption Assistance and Child Welfare Act                                                       |
| **5246**  | Medical care, unspecified                                                                       |
| **5231**  | Medicare eligibility determination                                                              |
| **5247**  | Mental health care, unspecified                                                                 |
| **5235**  | Self-injurious behaviors                                                                        |
| **5240**  | Race, unspecified                                                                               |
| **5245**  | Skin Infections                                                                                 |
| **5236**  | Suicide prevention                                                                              |
| **5227**  | End of life choice and DNR orders                                                               |
| **5244**  | Tuberculosis                                                                                    |
| **5237**  | Untreated pain                                                                                  |
| **5251**  | Immigration lawyers                                                                             |
| **5238**  | Vision care                                                                                     |
| **5611**  | Wellness/temperature checks ordered                                                             |
| **5276**  | Habeas Corpus                                                                                   |
| **5199**  | Individualized planning                                                                         |
| **5277**  | Over/Unlawful Detention                                                                         |
| **5298**  | Solitary confinement/Supermax (conditions or process)                                           |
| **11071** | Undue Burden                                                                                    |
| **5176**  | Assault/abuse by residents/inmates/students                                                     |
| **5297**  | Conditions of confinement                                                                       |
| **5282**  | Conflict of interest                                                                            |
| **5194**  | Funding                                                                                         |
| **5280**  | Good time                                                                                       |
| **5278**  | Grievance procedures                                                                            |
| **5279**  | Post-PLRA Population Cap                                                                        |
| **5299**  | Pre-PLRA Population Cap                                                                         |
| **5283**  | Housing Authority                                                                               |
| **5289**  | Jurisdiction-wide                                                                               |
| **5284**  | Law-enforcement                                                                                 |
| **5290**  | City/County Plaintiff                                                                           |
| **5577**  | Public (for-profit) corporation                                                                 |
| **5323**  | Bank or credit provider                                                                         |
| **5328**  | Fetus Identity                                                                                  |
| **5335**  | Commerce Power                                                                                  |
| **5314**  | Due Process                                                                                     |
| **5338**  | Abortion                                                                                        |
| **5337**  | Contraception                                                                                   |
| **5326**  | Marriage                                                                                        |
| **5303**  | Parole grant/revocation                                                                         |
| **5313**  | Quality of representation                                                                       |
| **5305**  | Records Disclosure                                                                              |
| **5304**  | Sex offender regulation                                                                         |
| **5333**  | TTY/Close Captioning/Videophone/etc.                                                            |
| **5329**  | Work release or work assignments                                                                |
| **5302**  | Seniority                                                                                       |
| **5336**  | Full faith and credit                                                                           |
| **5316**  | Right to travel                                                                                 |
| **5317**  | Self-incrimination                                                                              |
| **5325**  | Arabic                                                                                          |
| **5315**  | Ex Post Facto                                                                                   |
| **5324**  | Insurer                                                                                         |
| **5321**  | Multi-family housing provider                                                                   |
| **5332**  | Hearing impairment                                                                              |
| **5368**  | Release Requested                                                                               |
| **5361**  | Petitions clause                                                                                |
| **5364**  | Suspension Clause                                                                               |
| **5367**  | Mitigation Granted                                                                              |
| **5369**  | Release Granted                                                                                 |
| **5365**  | Families First Coronavirus Response Act (FFRCA)                                                 |
| **5363**  | Due Process: Substantive Due Process                                                            |
| **5355**  | Threatened/endangered flora                                                                     |
| **5356**  | Concentrated Animal Feeding Operations (CAFOs)                                                  |
| **5376**  | Release granted-group                                                                           |
| **5353**  | Discharge without permits                                                                       |
| **5359**  | Effective Communication (ADA)                                                                   |
| **5347**  | Excessive bail/fines                                                                            |
| **5360**  | Forced labor                                                                                    |
| **5340**  | Screen readers and similar accessibility devices                                                |
| **5349**  | Petroleum and petroleum byproducts                                                              |
| **5348**  | Slavery/Involuntary servitude                                                                   |
| **5350**  | Groundwater                                                                                     |
| **5351**  | Navigable waters                                                                                |
| **5357**  | Road construction                                                                               |
| **5354**  | Threatened/endangered fauna                                                                     |
| **5352**  | Underground Storage Tank (UST) leakage                                                          |
| **5372**  | American Indian Tribe                                                                           |
| **5456**  | Hepatitis                                                                                       |
| **5377**  | Release-process created/modified                                                                |
| **5395**  | Mental impairment                                                                               |
| **5402**  | Adoption                                                                                        |
| **5413**  | Sterilization/sexual rights                                                                     |
| **5387**  | Black                                                                                           |
| **5403**  | Aggressive behavior                                                                             |
| **5392**  | Female                                                                                          |
| **5383**  | Totality of conditions                                                                          |
| **5404**  | Bathing and hygiene                                                                             |
| **5393**  | Mobility impairment                                                                             |
| **5390**  | White                                                                                           |
| **5405**  | Commitment procedure                                                                            |
| **5406**  | Communication skills                                                                            |
| **5407**  | Confidentiality                                                                                 |
| **5401**  | Restraints : physical                                                                           |
| **5409**  | Deinstitutionalization/decarceration                                                            |
| **5408**  | Confinement/isolation                                                                           |
| **5399**  | Youth / Adult separation                                                                        |
| **5397**  | Chinese                                                                                         |
| **5410**  | Discharge & termination plans                                                                   |
| **5386**  | Education                                                                                       |
| **5398**  | Vietnamese                                                                                      |
| **5389**  | Asian/Pacific Islander                                                                          |
| **5394**  | Visual impairment                                                                               |
| **5380**  | Religious programs / policies                                                                   |
| **5412**  | Special education                                                                               |
| **5382**  | Sex w/ staff; sexual harassment by staff                                                        |
| **5391**  | Male                                                                                            |
| **5414**  | Timeliness of case assignment                                                                   |
| **5416**  | Wait lists                                                                                      |
| **5381**  | Sex discrimination                                                                              |
| **5396**  | Spanish                                                                                         |
| **5400**  | Restraints : chemical                                                                           |
| **5411**  | Siblings (visitation, placement)                                                                |
| **5385**  | Disability (inc. reasonable accommodations)                                                     |
| **5417**  | Other                                                                                           |
| **5450**  | False arrest                                                                                    |
| **5446**  | Improper treatment of mentally ill suspects                                                     |
| **5447**  | Improper use of canines                                                                         |
| **5448**  | Inadequate citizen complaint investigations and procedures                                      |
| **5453**  | Racial profiling                                                                                |
| **5420**  | Autism                                                                                          |
| **5421**  | Brain injury                                                                                    |
| **5422**  | Cerebral palsy                                                                                  |
| **5427**  | Depression                                                                                      |
| **5423**  | Developmental disability without intellectual disability                                        |
| **5424**  | Down syndrome                                                                                   |
| **5428**  | Learning disability                                                                             |
| **5426**  | Multiple sclerosis                                                                              |
| **5419**  | Schizophrenia                                                                                   |
| **5452**  | EEOC Plaintiff                                                                                  |
| **5451**  | Private Plaintiff                                                                               |
| **5455**  | State Plaintiff                                                                                 |
| **5436**  | Results test                                                                                    |
| **5488**  | Disparate Impact                                                                                |
| **5480**  | Age discrimination                                                                              |
| **5489**  | Disparate Treatment                                                                             |
| **5490**  | Pattern or Practice                                                                             |
| **5484**  | Predatory lending                                                                               |
| **5487**  | Retaliation                                                                                     |
| **5481**  | Contracting                                                                                     |
| **5491**  | Hiring                                                                                          |
| **5482**  | Insurance                                                                                       |
| **5494**  | Medical Exam / Inquiry                                                                          |
| **5459**  | Admission - procedure                                                                           |
| **5493**  | Training                                                                                        |
| **5485**  | Steering                                                                                        |
| **5492**  | Testing                                                                                         |
| **5460**  | Asylum - criteria                                                                               |
| **5478**  | Family discrimination                                                                           |
| **5479**  | Pregnancy discrimination                                                                        |
| **5477**  | Religion discrimination                                                                         |
| **5461**  | Asylum - procedure                                                                              |
| **5483**  | Lending                                                                                         |
| **5462**  | Border police                                                                                   |
| **5486**  | Zoning                                                                                          |
| **5495**  | Pay / Benefits                                                                                  |
| **5501**  | Demotion                                                                                        |
| **5502**  | Discharge / Constructive Discharge / Layoff                                                     |
| **5512**  | Housing Sales/Rental                                                                            |
| **5499**  | Other Conditions of Employment (including assignment, transfer, hours, working conditions, etc) |
| **5500**  | Promotion                                                                                       |
| **5503**  | College/University                                                                              |
| **5504**  | Corrections                                                                                     |
| **5505**  | Elementary/Secondary School                                                                     |
| **5563**  | Movie Theater or Other Entertainment facility                                                   |
| **5561**  | Restaurant                                                                                      |
| **5554**  | Currency                                                                                        |
| **5547**  | Access to public accommodations - privately owned                                               |
| **5568**  | ATM Machines                                                                                    |
| **5550**  | Barrier Removal                                                                                 |
| **5562**  | Bathrooms                                                                                       |
| **5555**  | Buildings                                                                                       |
| **5552**  | Courts                                                                                          |
| **5566**  | Housing                                                                                         |
| **5570**  | Other                                                                                           |
| **5569**  | Other Banking                                                                                   |
| **5557**  | Parking                                                                                         |
| **5537**  | Equal Protection                                                                                |
| **5548**  | Reasonable Accommodations                                                                       |
| **5559**  | Retail Shopping                                                                                 |
| **5549**  | Reasonable Modifications                                                                        |
| **5572**  | Watchlist                                                                                       |
| **5564**  | School/University Facilities                                                                    |
| **5571**  | Cruel and Unusual Punishment                                                                    |
| **5565**  | School/University policies                                                                      |
| **5553**  | Sidewalks                                                                                       |
| **5558**  | Testing                                                                                         |
| **5567**  | Transportation                                                                                  |
| **5551**  | Voting                                                                                          |
| **5560**  | Website                                                                                         |
| **5556**  | Government services                                                                             |
| **5607**  | Social distancing ordered                                                                       |
| **5591**  | Criminal                                                                                        |
| **5602**  | Transfer-ordered or process created/modified                                                    |
| **5588**  | Reproductive health care (including birth control, abortion, and others)                        |
| **5606**  | Population-Medically vulnerable                                                                 |
| **5593**  | Appellate Court is initial court                                                                |
| **5592**  | Habeas                                                                                          |
| **5596**  | Non-court arbitration/mediation                                                                 |
| **5601**  | Population reduction/cap                                                                        |
| **5597**  | Warrant or subpoena application                                                                 |
| **5590**  | Fines/Fees/Bail/Bond                                                                            |
| **5582**  | Forfeiture                                                                                      |
| **5608**  | Quarantine/isolation ordered                                                                    |
| **5605**  | CDC Guidance ordered implemented                                                                |
| **5586**  | Pepper/OC spray                                                                                 |
| **5578**  | Closely-held (for profit) corporation                                                           |
| **5604**  | COVID vaccination ordered                                                                       |
| **5583**  | Prison Rape Elimination Act                                                                     |
| **5584**  | Non-DOJ federal government plaintiff                                                            |
| **5603**  | Video court ordered                                                                             |
| **5581**  | Supremacy Clause                                                                                |
| **5598**  | Emoluments Clauses                                                                              |
| **5587**  | Takings                                                                                         |
| **5627**  | P\&A Associational Standing                                                                     |
| **5623**  | Attorneys fees or sanctions ordered                                                             |
| **5616**  | Exercise/recreation regulated                                                                   |
| **5620**  | Inspection ordered/regulated                                                                    |
| **5624**  | American Rescue Plan (ARP)                                                                      |
| **5619**  | Independent monitor/inspector imposed/assisted                                                  |
| **5625**  | CARES Act (Covid-related)                                                                       |
| **5613**  | PPE-ordered worn by staff                                                                       |
| **5622**  | Non-retaliation ordered                                                                         |
| **5621**  | COVID reporting ordered                                                                         |
| **5626**  | P\&A access authority                                                                           |
| **5615**  | Out-of-cell time regulated                                                                      |
| **5617**  | Programming regulated                                                                           |
| **5618**  | Solitary confinement regulated                                                                  |
| **5346**  | Sanctuary city/state                                                                            |
| **11080** | Opioid disorder/medication                                                                      |
| **5188**  | Fire safety                                                                                     |
| **5312**  | Public benefits (includes, e.g., in-state tuition, govt. jobs)                                  |
| **5260**  | Undocumented immigrants - state and local regulation                                            |
| **5261**  | Work authorization - criteria                                                                   |
| **5171**  | Assault/abuse by staff                                                                          |
| **38502** | EMTALA (42 U.S.C. § 1395dd)                                                                     |
| **5184**  | Recreation / Exercise                                                                           |
| **5183**  | Sanitation / living conditions                                                                  |
| **5185**  | Visiting                                                                                        |
| **5438**  | Vote decision rules                                                                             |
| **5345**  | Border wall                                                                                     |
| **5574**  | Required disclosure                                                                             |
| **11092** | Sports                                                                                          |
| **5204**  | Least restrictive environment                                                                   |
| **5195**  | Gay/lesbian/transgender                                                                         |
| **5375**  | Release granted-individual                                                                      |
| **5374**  | Tribal Court                                                                                    |
| **5371**  | Release Denied                                                                                  |
| **5373**  | Enumerations Clause                                                                             |
| **5202**  | Juveniles                                                                                       |
| **5196**  | Habilitation (training/treatment)                                                               |
| **11039** | Birth control restrictions                                                                      |
| **5362**  | Due Process: Procedural Due Process                                                             |
| **5309**  | Visas - procedures                                                                              |
| **5177**  | Personal injury                                                                                 |
| **5198**  | Incident/accident reporting & investigations                                                    |
| **5226**  | Dental care                                                                                     |
| **5229**  | ICF/MR & HCFA standards                                                                         |
| **5191**  | Family abuse and neglect                                                                        |
| **5575**  | Torture                                                                                         |
| **5358**  | Environmental Impact Statements                                                                 |
| **5497**  | Discipline                                                                                      |
| **5496**  | Harassment / Hostile Work Environment                                                           |
| **5458**  | Admission - criteria                                                                            |
| **5275**  | Women, Infants, and Children (WIC)                                                              |
| **5457**  | Lethal Injection - General                                                                      |
| **5498**  | Accommodation / Leave                                                                           |
| **5301**  | Military status discrimination                                                                  |
| **5384**  | Race discrimination                                                                             |
| **5418**  | American Indian/Alaskan Native                                                                  |
| **5425**  | Intellectual/developmental disability, unspecified                                              |
| **5527**  | Discrimination Prohibition                                                                      |
| **5523**  | Expungement of Employment Record                                                                |
| **5192**  | Family reunification                                                                            |
| **5379**  | Library (non-law) access                                                                        |
| **5189**  | Access to lawyers or judicial system                                                            |
| **5172**  | Administrative segregation                                                                      |
| **5248**  | Excessive force                                                                                 |
| **11023** | Admitting privileges                                                                            |
| **5170**  | Classification / placement                                                                      |
| **5265**  | Comprehensive Employment and Training Act (CETA)                                                |
| **5193**  | Foster care (benefits, training)                                                                |
| **5378**  | Law library access                                                                              |
| **5594**  | Multi-District Litigation (MDL)                                                                 |
| **5437**  | Test or device                                                                                  |
| **5415**  | Voting access                                                                                   |
| **5339**  | Immigration status                                                                              |
| **5281**  | Language discrimination                                                                         |
| **5476**  | National origin discrimination                                                                  |
| **5319**  | Sexual orientation                                                                              |
| **5609**  | Contact tracing ordered                                                                         |
| **5366**  | Mitigation Requested                                                                            |
| **5612**  | PPE-ordered provided to prisoners for free                                                      |
| **5614**  | Sanitizer/Handsoap ordered made available/used                                                  |
| **5287**  | Sanitation/Public Works                                                                         |
| **5267**  | Earned Income Tax Credit (EITC)                                                                 |
| **5288**  | Transportation                                                                                  |
| **5600**  | DACA (Deferred Action for Childhood Arrivals)                                                   |
| **5268**  | Food stamps/SNAP                                                                                |
| **5269**  | Medicaid                                                                                        |
| **5270**  | Medicare                                                                                        |
| **5272**  | Social Security Retirement and Death Benefit                                                    |
| **5273**  | SSI                                                                                             |
| **5599**  | Stewart B. McKinney Homeless Assistance Act, 42 U.S.C.A. §§ 11301 et seq.                       |
| **5271**  | Temporary Assistance for Needy Families (TANF)                                                  |
| **5513**  | Direct Suit on Merits                                                                           |
| **5516**  | EEOC Intervened in Private Suit                                                                 |
| **5517**  | Private Party intervened in EEOC suit                                                           |
| **5515**  | Private Suit Related / Consolidated with EEOC Suit                                              |
| **5274**  | SSDI                                                                                            |
| **5595**  | Out-of-court                                                                                    |
| **5370**  | Mitigation Denied                                                                               |
| **5320**  | Gender identity                                                                                 |
| **5510**  | Establishment Clause                                                                            |
| **5431**  | Non-government for-profit                                                                       |
| **5509**  | Free Exercise Clause                                                                            |
| **5432**  | Candidate qualifications                                                                        |
| **5511**  | Freedom of speech/association                                                                   |
| **5445**  | Unreasonable search and seizure                                                                 |
| **5475**  | Federalism (including 10th Amendment)                                                           |
| **5433**  | Challenges to at-large/multimember district/election                                            |
| **5434**  | Election administration                                                                         |
| **5223**  | HIV/AIDS                                                                                        |
| **5546**  | Access to public accommodations - governmental                                                  |
| **5576**  | Extradition                                                                                     |
| **5249**  | Failure to discipline                                                                           |
| **5444**  | Failure to train                                                                                |
| **5300**  | Intellectual/Developmental Disability                                                           |
| **5441**  | Voter registration rules                                                                        |
| **5291**  | Electric chair                                                                                  |
| **5435**  | Redistricting/district composition                                                              |
| **5293**  | Gas Chamber                                                                                     |
| **5292**  | Hanging                                                                                         |
| **5294**  | Lethal Injection - Chemicals Used                                                               |
| **5439**  | Vote dilution                                                                                   |
| **5334**  | Voter ID                                                                                        |
| **5440**  | Voter qualifications                                                                            |
| **5507**  | Hospital/Health Department                                                                      |
| **5285**  | Parks                                                                                           |
| **5286**  | Retailer                                                                                        |
| **5454**  | U.S. Dept of Justice plaintiff                                                                  |
| **5506**  | Fire                                                                                            |
| **5580**  | Non-profit NON-religious organization                                                           |
| **11037** | Spousal notification                                                                            |
| **11035** | Licensing restriction                                                                           |
| **5465**  | Criminal prosecution                                                                            |
| **5311**  | Cuban/Haitian entrant                                                                           |
| **5466**  | Deportation - criteria                                                                          |
| **5468**  | Deportation - judicial review                                                                   |
| **5467**  | Deportation - procedure                                                                         |
| **5469**  | Detention - conditions                                                                          |
| **5470**  | Detention - criteria                                                                            |
| **5471**  | Detention - procedures                                                                          |
| **5472**  | Employer sanctions                                                                              |
| **5473**  | Employment                                                                                      |
| **5474**  | Family Separation                                                                               |
| **5296**  | ICE/DHS/INS raid                                                                                |
| **5306**  | Legalization/Amnesty                                                                            |
| **5253**  | Refugees                                                                                        |
| **5307**  | Status/Classification                                                                           |
| **5310**  | Temporary foreign workers program                                                               |
| **5254**  | Temporary protected status                                                                      |
| **5255**  | Temporary visitors                                                                              |
| **5259**  | Undocumented immigrants - rights and duties                                                     |
| **5257**  | U.S. citizenship - acquiring                                                                    |
| **5258**  | U.S. citizenship - losing                                                                       |
| **5262**  | Work authorization - procedures                                                                 |
| **5542**  | Auditing                                                                                        |
| **5342**  | Busing                                                                                          |
| **5533**  | Comply with advertising/recruiting requirements                                                 |
| **5529**  | Develop anti-discrimination policy                                                              |
| **5532**  | Follow recruitment, hiring, or promotion protocols                                              |
| **5544**  | Goals (e.g., for hiring, admissions)                                                            |
| **5519**  | Hire                                                                                            |
| **5538**  | Implement complaint/dispute resolution process                                                  |
| **5508**  | Quality of representation                                                                       |
| **5463**  | Constitutional rights                                                                           |
| **5464**  | Convention against Torture                                                                      |
| **5540**  | Monitor/Master                                                                                  |
| **11042** | Mandatory delay                                                                                 |
| **5534**  | Other requirements regarding hiring, promotion, retention                                       |
| **11040** | Method-based abortion procedures                                                                |
| **5524**  | Neutral/Positive Reference                                                                      |
| **5530**  | Utilize objective job description                                                               |
| **5521**  | Position Restored                                                                               |
| **5535**  | Post/Distribute Notice of Rights / EE Law                                                       |
| **5331**  | Preliminary relief denied                                                                       |
| **5330**  | Preliminary relief granted                                                                      |
| **5628**  | Preliminary relief request withdrawn/mooted                                                     |
| **5520**  | Promotion                                                                                       |
| **5536**  | Provide antidiscrimination training                                                             |
| **5526**  | Reasonable Accommodation                                                                        |
| **5327**  | Receivership                                                                                    |
| **5541**  | Recordkeeping                                                                                   |
| **5522**  | Reinstatement                                                                                   |
| **5344**  | Remedial education                                                                              |
| **5539**  | Reporting                                                                                       |
| **5528**  | Retaliation Prohibition                                                                         |
| **5525**  | Retroactive Seniority                                                                           |
| **5343**  | Student assignment                                                                              |
| **5585**  | Training                                                                                        |
| **5531**  | Utilize objective hiring/promotion criteria                                                     |
| **5388**  | Hispanic                                                                                        |
| **5221**  | Indian                                                                                          |
| **11043** | Parental notification                                                                           |
| **5341**  | Magnet school                                                                                   |
| **5543**  | Monitoring                                                                                      |
| **11041** | Complete abortion ban                                                                           |
| **11048** | Disposal procedures                                                                             |
| **11038** | Time-based abortion prohibition                                                                 |
| **5295**  | Lethal Injection - Staffing (including physician)                                               |
| **5322**  | Single family housing provider                                                                  |
| **5429**  | Government-run                                                                                  |
| **11046** | Physician-only abortion laws                                                                    |
| **11047** | Telemedicine                                                                                    |
| **11049** | Facility requirements                                                                           |
| **11045** | Medication abortion                                                                             |
| **11044** | Cardiac activity legislation                                                                    |
| **5430**  | Non-government non-profit                                                                       |
| **11051** | Patient disclosure requirement                                                                  |
| **5308**  | Visas - criteria                                                                                |
| **5518**  | Apology                                                                                         |

For more information about case issues, see [Issues](/api-reference-v2p1/objects/case/issues).

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?issues=5264
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Custom Issue

Filter cases by custom issue

## Filter by case custom issue (integer).

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

#### Query Parameters

| Name                                                | Type    | Description                                                                 |
| --------------------------------------------------- | ------- | --------------------------------------------------------------------------- |
| custom\_issue\_id<mark style="color:red;">\*</mark> | integer | Custom issue ID (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 custom issue IDs (custom\_issue\_id):

| **6620**  | immunization                                                                                                                                                                                              |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **6621**  | deprivation of good time credits                                                                                                                                                                          |
| **6622**  | special election                                                                                                                                                                                          |
| **6623**  | prenatal care                                                                                                                                                                                             |
| **6624**  | Failure to obtain Voting Rights Act approval                                                                                                                                                              |
| **6625**  | unknown                                                                                                                                                                                                   |
| **6626**  | unknown                                                                                                                                                                                                   |
| **6627**  | Ventilation, light, heat and noise control                                                                                                                                                                |
| **6628**  | Massive and pervasive idleness because of lack of productive activity.                                                                                                                                    |
| **6629**  | Access to ballot                                                                                                                                                                                          |
| **6630**  | double-celling                                                                                                                                                                                            |
| **6631**  | election of judges                                                                                                                                                                                        |
| **6632**  | Access to courthouses                                                                                                                                                                                     |
| **6633**  | Town Incorporation                                                                                                                                                                                        |
| **7698**  | Parole Termination                                                                                                                                                                                        |
| **6634**  | geographic discrimination                                                                                                                                                                                 |
| **6635**  | "non-resident" on-campus University student populations                                                                                                                                                   |
| **6636**  | Race Discrimination                                                                                                                                                                                       |
| **6637**  | unknown                                                                                                                                                                                                   |
| **11068** | Denial of Procedural Due Process under the Oneida Nation Constitution                                                                                                                                     |
| **6638**  | unknown                                                                                                                                                                                                   |
| **6639**  | Removal of elected official                                                                                                                                                                               |
| **6640**  | voting jurisdiction                                                                                                                                                                                       |
| **11069** | Denial of the Right to Vote under the Oneida Nation Constitution                                                                                                                                          |
| **6641**  | Challenge to the constitutionality of 42 U.S.C. §14141                                                                                                                                                    |
| **6642**  | Illegal strip search                                                                                                                                                                                      |
| **6643**  | Racial discrimination in hiring practices                                                                                                                                                                 |
| **6644**  | racial discrimination in distribution of funding                                                                                                                                                          |
| **6645**  | Improper search and seizure                                                                                                                                                                               |
| **11070** | Indian Civil Rights Act                                                                                                                                                                                   |
| **6646**  | Use of pepper spray                                                                                                                                                                                       |
| **6647**  | Pretextual stop of motor vehicle                                                                                                                                                                          |
| **6648**  | racial discrimination                                                                                                                                                                                     |
| **6962**  | Overhaul inadequate system for serving the mentally disabled                                                                                                                                              |
| **6963**  | Implementation of program to transition suited individuals to appropriate communities                                                                                                                     |
| **6964**  | Reallocation of funds                                                                                                                                                                                     |
| **6965**  | Improve individualized planning and community placement                                                                                                                                                   |
| **6966**  | Develop new appeal policy for decisions by the state to withhold inmates' mail                                                                                                                            |
| **6967**  | Back pay                                                                                                                                                                                                  |
| **6649**  | racial discrimination                                                                                                                                                                                     |
| **6650**  | demolition of public housing                                                                                                                                                                              |
| **6651**  | Use of pepper spray                                                                                                                                                                                       |
| **6652**  | Fee assessment for jail services                                                                                                                                                                          |
| **6653**  | Timlely transfer to state prison system                                                                                                                                                                   |
| **6654**  | Violation of Full Faith and Credit Clause                                                                                                                                                                 |
| **6655**  | Female reproductive rights/abortion                                                                                                                                                                       |
| **6656**  | Videotaping public gatherings and preserving the videotapes                                                                                                                                               |
| **6657**  | Whether Vermont's Human Rights Act applied to prisons                                                                                                                                                     |
| **6968**  | Incarceration                                                                                                                                                                                             |
| **6969**  | Follow a new test for status                                                                                                                                                                              |
| **6970**  | Sexual harassment                                                                                                                                                                                         |
| **6971**  | Compensation                                                                                                                                                                                              |
| **6972**  | Undo discriminatory practices                                                                                                                                                                             |
| **6973**  | Accept mail that isn't a post card.                                                                                                                                                                       |
| **6974**  | City of Montgomery enjoined from attempting to collect amounts associated with traffic tickets                                                                                                            |
| **6975**  | Housing Support                                                                                                                                                                                           |
| **6976**  | Attorney's fees                                                                                                                                                                                           |
| **6977**  | Declaration of policies as discriminatory                                                                                                                                                                 |
| **6978**  | Provide required healthcare                                                                                                                                                                               |
| **6979**  | Reasonable fear determinations delays                                                                                                                                                                     |
| **6980**  | Discrimination against organizations and individuals that oppose contraception and abortion.                                                                                                              |
| **6981**  | Barred enforcement of state order                                                                                                                                                                         |
| **6982**  | Develop policy on reviewing potential parole violations                                                                                                                                                   |
| **6983**  | Notice of evidence used in gang validation determination and the opportunity to respond                                                                                                                   |
| **6984**  | Enjoined from total ban on Melanic literature                                                                                                                                                             |
| **6985**  | Pre-emption of state law                                                                                                                                                                                  |
| **6986**  | Prohibition of enforcement of state law                                                                                                                                                                   |
| **6987**  | preliminary injunction dissolved upon dismissal                                                                                                                                                           |
| **6988**  | Expedited Food Stamp processing                                                                                                                                                                           |
| **6989**  | Training                                                                                                                                                                                                  |
| **6658**  | Surveillance and intelligence-gathering activities of polical groups                                                                                                                                      |
| **6659**  | diabetic/insulin issues                                                                                                                                                                                   |
| **6660**  | Juvenile detainees being transferred to adult prisons                                                                                                                                                     |
| **6661**  | Challenged to DOJ's certification process under CRIPA                                                                                                                                                     |
| **6662**  | employment discrimination                                                                                                                                                                                 |
| **6663**  | Parole Revocation Procedure                                                                                                                                                                               |
| **6664**  | Community housing                                                                                                                                                                                         |
| **6665**  | State's responsibility for long-term residential placement                                                                                                                                                |
| **6666**  | Community residential placements                                                                                                                                                                          |
| **6667**  | Community-based treatment                                                                                                                                                                                 |
| **6668**  | Objection to construction of new non-community facility                                                                                                                                                   |
| **6669**  | lending                                                                                                                                                                                                   |
| **6670**  | Denial of right of association                                                                                                                                                                            |
| **6671**  | Qualification of Signatures on a Petition                                                                                                                                                                 |
| **6672**  | Plaintiff claimed poor voters were exploited in the 2002 elections                                                                                                                                        |
| **6673**  | Special election schedule                                                                                                                                                                                 |
| **6674**  | Community placement                                                                                                                                                                                       |
| **6675**  | Failure to obtain preclearance                                                                                                                                                                            |
| **6676**  | Transfer of inmates to out-of-state prisons                                                                                                                                                               |
| **38500** | State Secrets Privilege                                                                                                                                                                                   |
| **11081** | Take Care Clause                                                                                                                                                                                          |
| **11083** | writ of mandamus                                                                                                                                                                                          |
| **11084** | Spending Clause                                                                                                                                                                                           |
| **11085** | Ineffective assistance of counsel                                                                                                                                                                         |
| **6677**  | Challenge to NY's Sex Offender Registration Act                                                                                                                                                           |
| **6678**  | Employment discrimination                                                                                                                                                                                 |
| **6679**  | Sexual harassment by inmates                                                                                                                                                                              |
| **6680**  | classification/placement                                                                                                                                                                                  |
| **6681**  | disability (inc. reasonable accomodations)                                                                                                                                                                |
| **6682**  | education                                                                                                                                                                                                 |
| **6683**  | individual planning                                                                                                                                                                                       |
| **6700**  | First Amendment Right to Assemble/Protest                                                                                                                                                                 |
| **6701**  | Freedom of Speech, Expression, and Press                                                                                                                                                                  |
| **6684**  | least restrictive environment                                                                                                                                                                             |
| **6685**  | parental visitation/involvement                                                                                                                                                                           |
| **6686**  | parental visitation/involvement                                                                                                                                                                           |
| **6687**  | special education                                                                                                                                                                                         |
| **6688**  | Mental Disability                                                                                                                                                                                         |
| **6689**  | learning disability                                                                                                                                                                                       |
| **6690**  | Out-of-state placement                                                                                                                                                                                    |
| **6691**  | Right to Privacy                                                                                                                                                                                          |
| **6692**  | machine technology                                                                                                                                                                                        |
| **6693**  | machine technology                                                                                                                                                                                        |
| **6694**  | absentee ballots                                                                                                                                                                                          |
| **6695**  | Diabetes Care                                                                                                                                                                                             |
| **6696**  | Release of information                                                                                                                                                                                    |
| **6697**  | Solitary confinement                                                                                                                                                                                      |
| **6698**  | Solitary confinement                                                                                                                                                                                      |
| **6699**  | Constitutionality of ordinance restricting convicted sex offenders' rights                                                                                                                                |
| **6702**  | Workplace speech (political and religious)                                                                                                                                                                |
| **6703**  | Public transportation access                                                                                                                                                                              |
| **6704**  | Use of webcams in jail to show inmates on Internet                                                                                                                                                        |
| **6705**  | Probable Cause                                                                                                                                                                                            |
| **6706**  | Bedding / Beds                                                                                                                                                                                            |
| **6707**  | Investigation of First Amendment Conduct                                                                                                                                                                  |
| **6708**  | Negligent Supervision                                                                                                                                                                                     |
| **6709**  | Death Penalty                                                                                                                                                                                             |
| **6710**  | good time deprivation                                                                                                                                                                                     |
| **6711**  | slander                                                                                                                                                                                                   |
| **6712**  | breach of confidentiality                                                                                                                                                                                 |
| **6713**  | Negligence                                                                                                                                                                                                |
| **6714**  | freedom of information                                                                                                                                                                                    |
| **6715**  | cancer                                                                                                                                                                                                    |
| **6716**  | Stun belt                                                                                                                                                                                                 |
| **6717**  | Violation of free-speech rights                                                                                                                                                                           |
| **6726**  | Lack of staff                                                                                                                                                                                             |
| **6718**  | Incontinence                                                                                                                                                                                              |
| **6719**  | Advanced Care Planning                                                                                                                                                                                    |
| **6720**  | Wheelchair accessibility                                                                                                                                                                                  |
| **6721**  | Mental Health Care (General)                                                                                                                                                                              |
| **6722**  | Individualized Planning                                                                                                                                                                                   |
| **6723**  | Braille Education and Services                                                                                                                                                                            |
| **6724**  | Response to Allegations of Abuse/Neglect                                                                                                                                                                  |
| **6725**  | Residential Placement                                                                                                                                                                                     |
| **6727**  | First Amendment (Freedom of Speech)                                                                                                                                                                       |
| **6728**  | Protest                                                                                                                                                                                                   |
| **6729**  | Memorial Service                                                                                                                                                                                          |
| **6730**  | Pro-Life                                                                                                                                                                                                  |
| **6731**  | First Amendment (Establishment Clause)                                                                                                                                                                    |
| **6732**  | Abstinence                                                                                                                                                                                                |
| **11094** | Non-Delegation Doctrine                                                                                                                                                                                   |
| **11095** | Spending Clause                                                                                                                                                                                           |
| **6733**  | Education Funding                                                                                                                                                                                         |
| **6734**  | Religious assembly                                                                                                                                                                                        |
| **6735**  | Pre-Trial Treatment                                                                                                                                                                                       |
| **6736**  | Termination of Program                                                                                                                                                                                    |
| **6737**  | Judicial Influence/Interference                                                                                                                                                                           |
| **11096** | COVID-19 vaccine mandates                                                                                                                                                                                 |
| **6749**  | Transportation                                                                                                                                                                                            |
| **6750**  | Religious Questioning                                                                                                                                                                                     |
| **6738**  | Latino                                                                                                                                                                                                    |
| **6739**  | African-American                                                                                                                                                                                          |
| **6740**  | Student                                                                                                                                                                                                   |
| **6741**  | Suspension                                                                                                                                                                                                |
| **6742**  | Expulsion                                                                                                                                                                                                 |
| **6743**  | Due Process                                                                                                                                                                                               |
| **6744**  | Reassignment                                                                                                                                                                                              |
| **6745**  | Inadequate Funding                                                                                                                                                                                        |
| **6746**  | Lack of Oversight or Monitoring                                                                                                                                                                           |
| **6747**  | Lack of Oversight or Monitoring                                                                                                                                                                           |
| **6748**  | Language Barriers (no Spanish translations)                                                                                                                                                               |
| **6751**  | No official computerized voter list                                                                                                                                                                       |
| **6752**  | Adequate Spanish-speaking assistance                                                                                                                                                                      |
| **6753**  | racial segregation                                                                                                                                                                                        |
| **6754**  | Racially discriminatory lending                                                                                                                                                                           |
| **11097** | Federal employment vaccination mandate                                                                                                                                                                    |
| **11120** | Take care clause                                                                                                                                                                                          |
| **6755**  | racial segregation                                                                                                                                                                                        |
| **6756**  | credit card application                                                                                                                                                                                   |
| **6757**  | Housing Discrimination Based Soley on Race                                                                                                                                                                |
| **6758**  | African-American (black)                                                                                                                                                                                  |
| **6759**  | Mexican-American                                                                                                                                                                                          |
| **6760**  | Fair Lending                                                                                                                                                                                              |
| **6761**  | Loans                                                                                                                                                                                                     |
| **6762**  | breach of contract                                                                                                                                                                                        |
| **6763**  | intentional infliction of emotional distress                                                                                                                                                              |
| **6764**  | realty home sales                                                                                                                                                                                         |
| **6765**  | Female                                                                                                                                                                                                    |
| **6766**  | Fair Lending                                                                                                                                                                                              |
| **6767**  | Mortgage                                                                                                                                                                                                  |
| **6769**  | asbestos exposure                                                                                                                                                                                         |
| **6770**  | Redlining                                                                                                                                                                                                 |
| **6771**  | Cruel and Unusual Punishment                                                                                                                                                                              |
| **6768**  | National Urban Leage                                                                                                                                                                                      |
| **6772**  | Eviction                                                                                                                                                                                                  |
| **6773**  | Foreclosure                                                                                                                                                                                               |
| **6774**  | Preemption / Preempt                                                                                                                                                                                      |
| **6775**  | State Regulation                                                                                                                                                                                          |
| **6778**  | Supremacy Clause                                                                                                                                                                                          |
| **6776**  | Federal Home Loan Bank Board                                                                                                                                                                              |
| **6777**  | Home Owners' Loan Act \[HOLA]                                                                                                                                                                             |
| **6779**  | Fee schedule                                                                                                                                                                                              |
| **6780**  | red-lining                                                                                                                                                                                                |
| **6781**  | Redlining                                                                                                                                                                                                 |
| **6782**  | Insurance redlining                                                                                                                                                                                       |
| **6783**  | Insurance redlining                                                                                                                                                                                       |
| **6784**  | Redlining                                                                                                                                                                                                 |
| **6785**  | Redlining                                                                                                                                                                                                 |
| **6990**  | Develop correspondence policy                                                                                                                                                                             |
| **6991**  | Prohibit enforcing terms in Deputy Attorney General's letter restricting disclosure                                                                                                                       |
| **6786**  | Insurance Redlining                                                                                                                                                                                       |
| **6787**  | African-American (black)                                                                                                                                                                                  |
| **6788**  | Fair Housing Act                                                                                                                                                                                          |
| **6789**  | Fair Lending                                                                                                                                                                                              |
| **6790**  | Loan Discimination                                                                                                                                                                                        |
| **6791**  | Participation in the supervised furlough release program                                                                                                                                                  |
| **6792**  | Legal name change                                                                                                                                                                                         |
| **6793**  | Reverse Redlining                                                                                                                                                                                         |
| **6794**  | Pregnancy / Pregnant                                                                                                                                                                                      |
| **6800**  | False arrest                                                                                                                                                                                              |
| **6801**  | Lending Discrimination ("Redlining")                                                                                                                                                                      |
| **6802**  | African-American / Black                                                                                                                                                                                  |
| **6803**  | African-American / Black                                                                                                                                                                                  |
| **6795**  | Religious Observances (Dress)                                                                                                                                                                             |
| **6796**  | Negligence                                                                                                                                                                                                |
| **6797**  | Unlawful Transportation                                                                                                                                                                                   |
| **6798**  | DNA samples                                                                                                                                                                                               |
| **6799**  | Wrong Warrant Arrests                                                                                                                                                                                     |
| **6804**  | Maritial Status (Divorced)                                                                                                                                                                                |
| **6805**  | methicillin-resistant Staphylococcus aureus (MRSA)                                                                                                                                                        |
| **6806**  | blockbusting                                                                                                                                                                                              |
| **6807**  | redlining                                                                                                                                                                                                 |
| **6808**  | mortgage redlining                                                                                                                                                                                        |
| **6809**  | redlining                                                                                                                                                                                                 |
| **6810**  | mortgage redlining                                                                                                                                                                                        |
| **6811**  | Foreclosure                                                                                                                                                                                               |
| **6812**  | redlining                                                                                                                                                                                                 |
| **6813**  | Collateral                                                                                                                                                                                                |
| **6814**  | Missouri's State Children's Health Insurance Program (SCHIP)                                                                                                                                              |
| **6815**  | appraisal                                                                                                                                                                                                 |
| **6816**  | Disabled                                                                                                                                                                                                  |
| **6817**  | redlining                                                                                                                                                                                                 |
| **6818**  | membership rights                                                                                                                                                                                         |
| **6819**  | Epilepsy                                                                                                                                                                                                  |
| **6820**  | race and gender discrimination                                                                                                                                                                            |
| **6821**  | Native American                                                                                                                                                                                           |
| **6822**  | Native American                                                                                                                                                                                           |
| **6823**  | Double Celling                                                                                                                                                                                            |
| **38506** | First Amendment right of access                                                                                                                                                                           |
| **6835**  | prosecutorial failure to reveal evidence to the defense                                                                                                                                                   |
| **6836**  | ineffective assistance of counsel                                                                                                                                                                         |
| **6837**  | Constitutional challenge to federal civil committment procedure for sexual predators                                                                                                                      |
| **6838**  | Another plaintiff: Mexico consul                                                                                                                                                                          |
| **6824**  | racial integration                                                                                                                                                                                        |
| **6825**  | Racial Segregation                                                                                                                                                                                        |
| **6826**  | MRSA                                                                                                                                                                                                      |
| **6827**  | MRSA                                                                                                                                                                                                      |
| **6828**  | Cut-Down Procedure                                                                                                                                                                                        |
| **6829**  | Lethal Gas                                                                                                                                                                                                |
| **6830**  | parole hearings                                                                                                                                                                                           |
| **6831**  | participation of state-licensed physicians in the execution process                                                                                                                                       |
| **6832**  | sex-offender registry                                                                                                                                                                                     |
| **6833**  | parole revocation hearings                                                                                                                                                                                |
| **6834**  | Custodial interrogation                                                                                                                                                                                   |
| **6839**  | Vocational programs                                                                                                                                                                                       |
| **6840**  | Conspiracy to hire illegal immigrants                                                                                                                                                                     |
| **6844**  | Immigrant Investors “EB–5’’ program                                                                                                                                                                       |
| **6845**  | Immigrant Investors “EB–5’’ program                                                                                                                                                                       |
| **6846**  | Harboring illegal aliens                                                                                                                                                                                  |
| **6847**  | "Front desking" of immigration applications                                                                                                                                                               |
| **6848**  | Advance parole or travel restrictions                                                                                                                                                                     |
| **6849**  | "Front desking" of immigration applications                                                                                                                                                               |
| **6841**  | Unconstitutional treatment of juvenile parolees                                                                                                                                                           |
| **6842**  | Right to counsel in juvenile parole hearings                                                                                                                                                              |
| **6843**  | Due process protections in juvenile parole revocation proceedings                                                                                                                                         |
| **6850**  | Travel restrictions                                                                                                                                                                                       |
| **6851**  | Applications for benefits under the Family Unity Program                                                                                                                                                  |
| **38508** | Removal of social media ban                                                                                                                                                                               |
| **6869**  | public services                                                                                                                                                                                           |
| **6870**  | Detention transfer                                                                                                                                                                                        |
| **6871**  | Janitorial                                                                                                                                                                                                |
| **6852**  | Purchase of publications                                                                                                                                                                                  |
| **6853**  | Gift publications                                                                                                                                                                                         |
| **6854**  | Inmate bank account restrictions                                                                                                                                                                          |
| **6855**  | Interrogation of inmates regarding attorney-client conversations                                                                                                                                          |
| **6856**  | PLRA administrative remedy exhaustion requirement                                                                                                                                                         |
| **6857**  | Voluntary Departure Program                                                                                                                                                                               |
| **6858**  | Discloure of immigration information to the NCIC                                                                                                                                                          |
| **6859**  | "No match" letter                                                                                                                                                                                         |
| **6860**  | Social Security Administration - data discrepancy                                                                                                                                                         |
| **6861**  | FBI name checks                                                                                                                                                                                           |
| **6862**  | Adverse effect wage rate (AEWR)                                                                                                                                                                           |
| **6863**  | County                                                                                                                                                                                                    |
| **6864**  | FBI name checks                                                                                                                                                                                           |
| **6865**  | FBI name checks                                                                                                                                                                                           |
| **6866**  | Private                                                                                                                                                                                                   |
| **6867**  | Legal permanent residence documentation                                                                                                                                                                   |
| **6868**  | Nazi reparations payments                                                                                                                                                                                 |
| **6872**  | H-2 temporary worker program                                                                                                                                                                              |
| **6873**  | Discrimination was a result of advertising in media outlets that had a primarily white readership                                                                                                         |
| **6874**  | Publisher only rule                                                                                                                                                                                       |
| **6893**  | Settlement: make community-based supported housing available to institutionalized mentally ill individuals.                                                                                               |
| **6894**  | Reduction in State's Medicaid reimbursement rate for health care services without prior CMS approval.                                                                                                     |
| **6895**  | Constitutional Clause: Supremacy Clause                                                                                                                                                                   |
| **6875**  | Repayment of incarceration costs                                                                                                                                                                          |
| **6876**  | Writing program                                                                                                                                                                                           |
| **6877**  | Private Trucking Company                                                                                                                                                                                  |
| **6878**  | Voting rights for parolees and state prisoners                                                                                                                                                            |
| **6879**  | crowd control policy                                                                                                                                                                                      |
| **6880**  | training                                                                                                                                                                                                  |
| **6881**  | Community outreach                                                                                                                                                                                        |
| **6882**  | performance evaluation and early identification                                                                                                                                                           |
| **6883**  | Establish and maintain IT systems                                                                                                                                                                         |
| **6884**  | Settlement/injunction content: prevent wage reduction, limit reduction of service hours.                                                                                                                  |
| **6885**  | Distribute sexual harrasment plicy to all employees                                                                                                                                                       |
| **6886**  | Reduction in State's reimbursement rate for Medicare fee-for-service providers                                                                                                                            |
| **6887**  | Supremacy Clause                                                                                                                                                                                          |
| **6888**  | Supremacy Clause                                                                                                                                                                                          |
| **6889**  | Reduction in State's Medicaid reimbursement rate for hospital services.                                                                                                                                   |
| **6890**  | Reduction in State's reimbursement rate for Medicaid fee-for-service providers                                                                                                                            |
| **6891**  | Constitutional Clause: Supremacy Clause                                                                                                                                                                   |
| **6892**  | severance pay                                                                                                                                                                                             |
| **6896**  | Reduction in State's Medicaid reimbursement rate for pharmaceuticals without prior CMS approval.                                                                                                          |
| **6897**  | Enforcement of a mediation agreement                                                                                                                                                                      |
| **6898**  | DOMA                                                                                                                                                                                                      |
| **38514** | Relocate polling place                                                                                                                                                                                    |
| **38515** | birth certificates                                                                                                                                                                                        |
| **6916**  | Failure to provide methods to assist communication                                                                                                                                                        |
| **6917**  | Permanently enjoined the implementation of a DOL rule                                                                                                                                                     |
| **38518** | Consumer Protection                                                                                                                                                                                       |
| **6899**  | Federal Employee Health Benefits                                                                                                                                                                          |
| **6900**  | experimental treatment                                                                                                                                                                                    |
| **6901**  | hypnotism                                                                                                                                                                                                 |
| **6902**  | improper parole conditions / requirements                                                                                                                                                                 |
| **6903**  | electric shock                                                                                                                                                                                            |
| **38520** | Voting method                                                                                                                                                                                             |
| **6904**  | Monitoring and recording of attorney-inmate calls                                                                                                                                                         |
| **6905**  | Search for and remove test results.                                                                                                                                                                       |
| **6906**  | California Public Employees Retirement System                                                                                                                                                             |
| **6907**  | sex offender registration conditions                                                                                                                                                                      |
| **6908**  | Bail hearing                                                                                                                                                                                              |
| **6909**  | Withdrawn without prejudice                                                                                                                                                                               |
| **6910**  | Lift nondisclosure requirements                                                                                                                                                                           |
| **6911**  | Bill of Attainder                                                                                                                                                                                         |
| **6912**  | Naturalization adjudication                                                                                                                                                                               |
| **6913**  | Lawful permanent residency                                                                                                                                                                                |
| **6914**  | Passport - procedures                                                                                                                                                                                     |
| **6915**  | Supremacy Clause                                                                                                                                                                                          |
| **6918**  | Freedom of Speech                                                                                                                                                                                         |
| **6919**  | Bill of Attainder                                                                                                                                                                                         |
| **6920**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6921**  | FISA order allowing surveillance                                                                                                                                                                          |
| **38521** | Separation of powers                                                                                                                                                                                      |
| **38522** | Privacy                                                                                                                                                                                                   |
| **38523** | conduct nonpartisan general election previously set and issue public notice                                                                                                                               |
| **38524** | Preclearance under Section 5 of the Voting Rights Act                                                                                                                                                     |
| **38516** | Birth Certificate                                                                                                                                                                                         |
| **38519** | Campaign Communications                                                                                                                                                                                   |
| **6926**  | Settlement Fund                                                                                                                                                                                           |
| **6922**  | Payment through a Settlement Fund to impacted Borrowers                                                                                                                                                   |
| **6923**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6924**  | "best ensures" accommodations                                                                                                                                                                             |
| **6925**  | Improve prison conditions                                                                                                                                                                                 |
| **6927**  | Settlement Fund                                                                                                                                                                                           |
| **6928**  | Stay enjoining enforcement of law                                                                                                                                                                         |
| **6929**  | Settlement Fund                                                                                                                                                                                           |
| **6930**  | Required to open new branches in minority neighborhoods                                                                                                                                                   |
| **6931**  | Donation to grant program with City of Detroit                                                                                                                                                            |
| **6942**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6943**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6944**  | Annotating scores of those who received accommodations prohibited                                                                                                                                         |
| **6945**  | Prevent retroactive enforcement of a new law                                                                                                                                                              |
| **6946**  | Build two softball fields                                                                                                                                                                                 |
| **6947**  | Required to release documents.                                                                                                                                                                            |
| **6932**  | Settlement Fund                                                                                                                                                                                           |
| **6933**  | Settlement Fund                                                                                                                                                                                           |
| **6934**  | Agreement to invest in the Community                                                                                                                                                                      |
| **6935**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6936**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6937**  | Distribute publication to inmate subscribers                                                                                                                                                              |
| **6938**  | Settlement Fund                                                                                                                                                                                           |
| **6939**  | Failure to fill an oversight committee                                                                                                                                                                    |
| **6940**  | Non-compliance with the county charter                                                                                                                                                                    |
| **6941**  | FISA order allowing surveillance                                                                                                                                                                          |
| **6948**  | Permit greater access to residents and facility                                                                                                                                                           |
| **6949**  | Provide support for integration into community                                                                                                                                                            |
| **6950**  | Improve conditions of confinement                                                                                                                                                                         |
| **6951**  | Reduce confinement time                                                                                                                                                                                   |
| **7554**  | test                                                                                                                                                                                                      |
| **6952**  | New strip search policy required                                                                                                                                                                          |
| **6953**  | Implement inmate population cap                                                                                                                                                                           |
| **6954**  | Provide additional training to staff                                                                                                                                                                      |
| **6955**  | Improve facilities' maintenance                                                                                                                                                                           |
| **6956**  | Provide legal access                                                                                                                                                                                      |
| **6957**  | Inmate cap imposed                                                                                                                                                                                        |
| **6958**  | Maintain a law library and allow access                                                                                                                                                                   |
| **6959**  | Provide better health care                                                                                                                                                                                |
| **6960**  | Provide more access to recreational activities and exercise                                                                                                                                               |
| **6961**  | back pay                                                                                                                                                                                                  |
| **6495**  | Development of policies to ensure adequate health care                                                                                                                                                    |
| **6496**  | Other issue                                                                                                                                                                                               |
| **6497**  | inmates having authority over other inmates                                                                                                                                                               |
| **6498**  | clothing allowance                                                                                                                                                                                        |
| **6499**  | work safety                                                                                                                                                                                               |
| **6500**  | lack of heat and hot water in winter                                                                                                                                                                      |
| **6501**  | employment opportunities                                                                                                                                                                                  |
| **6502**  | parole                                                                                                                                                                                                    |
| **6503**  | refusal to cooperate with CRIPA investigation                                                                                                                                                             |
| **6504**  | prison industry/work                                                                                                                                                                                      |
| **6505**  | work safety                                                                                                                                                                                               |
| **6506**  | wrongful incarceration                                                                                                                                                                                    |
| **6507**  | Universal bloodborne pathogen precautions                                                                                                                                                                 |
| **6508**  | Suspected the work programs for juvenile detainees violated the Fair Labor Standards Act                                                                                                                  |
| **6509**  | insufficient clothing provided                                                                                                                                                                            |
| **6510**  | maintenance of the commisary                                                                                                                                                                              |
| **6511**  | Vocational programs                                                                                                                                                                                       |
| **6512**  | Pest control                                                                                                                                                                                              |
| **6513**  | Plumbing                                                                                                                                                                                                  |
| **6514**  | Electricity                                                                                                                                                                                               |
| **6515**  | Temperature                                                                                                                                                                                               |
| **6516**  | Prisoner transfer to maximum security facilities                                                                                                                                                          |
| **6517**  | Facility inspection                                                                                                                                                                                       |
| **6518**  | Protection of named plaintiffs from retaliation                                                                                                                                                           |
| **6519**  | failure to provide clothing                                                                                                                                                                               |
| **6520**  | parole/release program                                                                                                                                                                                    |
| **6521**  | discrimination against handicapped inmates                                                                                                                                                                |
| **6522**  | Security                                                                                                                                                                                                  |
| **6523**  | censorship of reading materials                                                                                                                                                                           |
| **6524**  | inadequate provision of clothing                                                                                                                                                                          |
| **6525**  | Transfer of unhealthy inmates to other correctional facilities                                                                                                                                            |
| **6526**  | Status offenses against juveniles                                                                                                                                                                         |
| **6527**  | Challenges to the "Votomatic" punch card system                                                                                                                                                           |
| **6528**  | lack of physical therapy                                                                                                                                                                                  |
| **6529**  | abortion                                                                                                                                                                                                  |
| **6530**  | Aftercare                                                                                                                                                                                                 |
| **6531**  | Access to social services while in "lock down"                                                                                                                                                            |
| **6532**  | Court consistently took prolonged amounts of time to process paperwork for releasing and/or transferring juveniles                                                                                        |
| **6533**  | Vocational programming                                                                                                                                                                                    |
| **6534**  | Insufficient equipment                                                                                                                                                                                    |
| **6535**  | Diagnostic health services                                                                                                                                                                                |
| **6536**  | Drug and alcohol abuse                                                                                                                                                                                    |
| **6537**  | Room furnishings                                                                                                                                                                                          |
| **6538**  | Guidelines for fingerprinting and photographing                                                                                                                                                           |
| **6539**  | Notification of law enforcement agencies                                                                                                                                                                  |
| **6540**  | Provisions of the tribal constitution regarding elections violated the Equal Protection clause of the Fourteenth Amendment.                                                                               |
| **6541**  | Whether holding a recount violated tribal statutes.                                                                                                                                                       |
| **6542**  | Ballot Access                                                                                                                                                                                             |
| **6543**  | Voter Intimidation                                                                                                                                                                                        |
| **6544**  | Voter Intimidation                                                                                                                                                                                        |
| **6545**  | Disciplinary Procedures                                                                                                                                                                                   |
| **6546**  | Social Security Benefits                                                                                                                                                                                  |
| **6547**  | Disciplinary Procedures                                                                                                                                                                                   |
| **6548**  | Intercom monitoring                                                                                                                                                                                       |
| **6549**  | Due process                                                                                                                                                                                               |
| **6550**  | Blanket Primary                                                                                                                                                                                           |
| **6551**  | Political Association                                                                                                                                                                                     |
| **6552**  | N/A                                                                                                                                                                                                       |
| **6553**  | Duration of confinement                                                                                                                                                                                   |
| **6554**  | Adequacy of clothing                                                                                                                                                                                      |
| **6555**  | Plumbing                                                                                                                                                                                                  |
| **6556**  | Due process                                                                                                                                                                                               |
| **6557**  | Parole hearings                                                                                                                                                                                           |
| **6558**  | Tribal Constitution                                                                                                                                                                                       |
| **6559**  | Voter identification                                                                                                                                                                                      |
| **6560**  | Polling place placement                                                                                                                                                                                   |
| **6561**  | Employment                                                                                                                                                                                                |
| **6562**  | Out-of-cell time                                                                                                                                                                                          |
| **6563**  | Videotaping system                                                                                                                                                                                        |
| **6564**  | Vocational programs                                                                                                                                                                                       |
| **6565**  | Work-release program                                                                                                                                                                                      |
| **6566**  | Ballot recount                                                                                                                                                                                            |
| **6567**  | Physical therapy                                                                                                                                                                                          |
| **6568**  | Occupational therapy                                                                                                                                                                                      |
| **6569**  | unknown                                                                                                                                                                                                   |
| **6570**  | Pre-clearence                                                                                                                                                                                             |
| **6571**  | Appointment                                                                                                                                                                                               |
| **6572**  | candidate petition                                                                                                                                                                                        |
| **6573**  | Job Discrimination                                                                                                                                                                                        |
| **6574**  | Equal protection                                                                                                                                                                                          |
| **6575**  | Employment discrimination                                                                                                                                                                                 |
| **6576**  | Employment discrimination                                                                                                                                                                                 |
| **6577**  | Voter Initiated Recall                                                                                                                                                                                    |
| **6578**  | transfer without due process                                                                                                                                                                              |
| **6579**  | Construction of a new jail facility                                                                                                                                                                       |
| **6580**  | Confiscation of "booking fee" on entry to jail                                                                                                                                                            |
| **6581**  | Photo id                                                                                                                                                                                                  |
| **6582**  | education of homeless children                                                                                                                                                                            |
| **6583**  | Due Process Rights for Parole Hearings                                                                                                                                                                    |
| **6584**  | Urine Testing                                                                                                                                                                                             |
| **6585**  | deprivation of good time credits                                                                                                                                                                          |
| **6586**  | Law Library Access                                                                                                                                                                                        |
| **6587**  | sex offender treatment                                                                                                                                                                                    |
| **6588**  | telephone, mail restrictions                                                                                                                                                                              |
| **6589**  | Community Placement                                                                                                                                                                                       |
| **6590**  | abortion                                                                                                                                                                                                  |
| **6591**  | age qualifications                                                                                                                                                                                        |
| **6592**  | Delegates to state convention                                                                                                                                                                             |
| **6593**  | Equal access to public accommodations                                                                                                                                                                     |
| **6594**  | Political "smear" campaign                                                                                                                                                                                |
| **6595**  | Term limits                                                                                                                                                                                               |
| **6596**  | asbestos exposure                                                                                                                                                                                         |
| **6597**  | Challenge to open primary law                                                                                                                                                                             |
| **6598**  | inadequate heating                                                                                                                                                                                        |
| **6599**  | Decinneal Census Administration (Sampling)                                                                                                                                                                |
| **6600**  | Felon disenfranchisement                                                                                                                                                                                  |
| **6601**  | Disabled Service Provision under NVRA at universities                                                                                                                                                     |
| **6602**  | Ballot access requirements                                                                                                                                                                                |
| **6603**  | Failure to notify candidate of redistricting                                                                                                                                                              |
| **6604**  | Challenge to statutory maximum number of appearances on a single ballot                                                                                                                                   |
| **6605**  | Inadequate lighting                                                                                                                                                                                       |
| **6606**  | Poor ventilation                                                                                                                                                                                          |
| **6607**  | Unstable temperatures                                                                                                                                                                                     |
| **6608**  | Deteriorating Plumbing                                                                                                                                                                                    |
| **6609**  | Deteriorating heating systems                                                                                                                                                                             |
| **6610**  | Lack of employment and constructive activity                                                                                                                                                              |
| **6611**  | State Party Delegate Registration Fee                                                                                                                                                                     |
| **6612**  | Primary administration                                                                                                                                                                                    |
| **6613**  | School board appointive process                                                                                                                                                                           |
| **6614**  | delegate selection                                                                                                                                                                                        |
| **6615**  | Emergency Procedures                                                                                                                                                                                      |
| **6616**  | Challenge to the method of electing members of the City Council of the City of Manning                                                                                                                    |
| **6617**  | Town of Elloree City Council Members term of office increased from two to four years                                                                                                                      |
| **6618**  | Opportunity for African-American voters to participate in the political process and to elect candidates of their choice                                                                                   |
| **6619**  | Medical Records                                                                                                                                                                                           |
| **6992**  | Enjoined from violating First Amendment rights                                                                                                                                                            |
| **6993**  | Order requiring Texas to provide the plaintiff with an appropriate hearing regarding imposition of sex-offender conditions                                                                                |
| **6994**  | Limiting solitary confinement for juveniles                                                                                                                                                               |
| **6995**  | Develop discipline policy                                                                                                                                                                                 |
| **6996**  | Provision of grants to national consumer and minority consumer education programs                                                                                                                         |
| **6997**  | Child Find Duty                                                                                                                                                                                           |
| **6998**  | Make structural and programmatic changes to comply with ADA                                                                                                                                               |
| **6999**  | Order preventing the defendant's from enforcing R.S.Mo. § 589.426 against the plaintiffs                                                                                                                  |
| **7000**  | Resolve constitutionally inadequate conditions of confinement                                                                                                                                             |
| **7001**  | Provide nutritionally adequate food                                                                                                                                                                       |
| **7002**  | Development of health services and use-of-force policies                                                                                                                                                  |
| **7003**  | Post a copy of the Notice of Consent Decree                                                                                                                                                               |
| **7004**  | Equal Employment Opportunity Consultant                                                                                                                                                                   |
| **7005**  | Post Copy of Notice of Consent Decree                                                                                                                                                                     |
| **7006**  | Retain an Equal Employment Opportunity Consultant                                                                                                                                                         |
| **7007**  | Post notice of consent decree                                                                                                                                                                             |
| **7008**  | Post a copy of consent decree                                                                                                                                                                             |
| **7009**  | Post copy of consent decree                                                                                                                                                                               |
| **7010**  | Post a copy of consent decree                                                                                                                                                                             |
| **7011**  | Post a Copy of Consent Decree                                                                                                                                                                             |
| **7012**  | Hire equal employment consultant                                                                                                                                                                          |
| **7013**  | Hire eeo consultant                                                                                                                                                                                       |
| **7014**  | Hire equal opportunity employment consultant                                                                                                                                                              |
| **7015**  | Hire EEOC consultant                                                                                                                                                                                      |
| **7016**  | Hire equal employment consultant                                                                                                                                                                          |
| **7017**  | Hire EEOC Consultant                                                                                                                                                                                      |
| **7018**  | Post a copy of consent injunction in inmates' living area for a period of ninety days; maintain a permanent copy in the library                                                                           |
| **7019**  | Develop new mail policy and provide training to staff on implementing that policy                                                                                                                         |
| **7020**  | Objective performance evaluations                                                                                                                                                                         |
| **7021**  | Set forth compensation criteria                                                                                                                                                                           |
| **7022**  | Post all vacancies                                                                                                                                                                                        |
| **7023**  | Threatened Unlawful Termination                                                                                                                                                                           |
| **7024**  | Prohibit enforcement of same-sex marriage laws                                                                                                                                                            |
| **7025**  | Public Access to FISA Court § 702(i) Proceedings                                                                                                                                                          |
| **7026**  | Acquire and develop 30 units of public housing                                                                                                                                                            |
| **7027**  | Broaden public housing base, esp. low and moderate income housing                                                                                                                                         |
| **7028**  | American Sign Language                                                                                                                                                                                    |
| **7029**  | Timely assessment of child abuse and neglect reports                                                                                                                                                      |
| **7030**  | FISA certification, targeting, and minimization procedures review                                                                                                                                         |
| **7031**  | Forbidding the probate judges from issuing marriage licenses to same-sex couples                                                                                                                          |
| **7032**  | Case plans                                                                                                                                                                                                |
| **7033**  | Foster care maintenance payments                                                                                                                                                                          |
| **7034**  | Free speech                                                                                                                                                                                               |
| **7035**  | Free speech                                                                                                                                                                                               |
| **7036**  | Foster care maintenance payments                                                                                                                                                                          |
| **7037**  | Felon disqualification of job applicants.                                                                                                                                                                 |
| **7555**  | Hello                                                                                                                                                                                                     |
| **7038**  | Religious objections to issuing marriage licenses to same sex couples                                                                                                                                     |
| **7039**  | Citizenship Clause                                                                                                                                                                                        |
| **7040**  | Discrimination against employees with criminal background                                                                                                                                                 |
| **7041**  | develop training program                                                                                                                                                                                  |
| **7042**  | misuse of appropriated funds meant to provide employment for persons with disabilities                                                                                                                    |
| **7043**  | Faculty training                                                                                                                                                                                          |
| **7044**  | Student orientation session                                                                                                                                                                               |
| **7045**  | Sexual Violence Advisory Committee                                                                                                                                                                        |
| **7046**  | Hire a third party consultant                                                                                                                                                                             |
| **7047**  | Allow student to develop a Student Success Plan at any time                                                                                                                                               |
| **7048**  | Hold training program for employees                                                                                                                                                                       |
| **7049**  | Incorporate instruction on gender identity into curriculum                                                                                                                                                |
| **7050**  | Climate checks                                                                                                                                                                                            |
| **7051**  | Allow timely attorney visits                                                                                                                                                                              |
| **7052**  | Retain expert consultant                                                                                                                                                                                  |
| **7053**  | Inform transgender students of their right to form a support team                                                                                                                                         |
| **7054**  | Training for school administrators                                                                                                                                                                        |
| **7055**  | Governing individually identifiable health information (IIHI)                                                                                                                                             |
| **7056**  | Governing protected health information (PHI)                                                                                                                                                              |
| **7057**  | Referral to HIV specialist under certain conditions                                                                                                                                                       |
| **7058**  | The court ordered Geo to produce litigation-related documents pursuant to PLN's public records request                                                                                                    |
| **7059**  | Excessive Fines Clause                                                                                                                                                                                    |
| **7060**  | Implement changes in censorship practices                                                                                                                                                                 |
| **7061**  | Conform investigations involving political activity to constitution                                                                                                                                       |
| **7062**  | Remove antagonizing report from website                                                                                                                                                                   |
| **7063**  | Institute fairness hearings                                                                                                                                                                               |
| **7064**  | Develop a lawful selection procedure for appointment                                                                                                                                                      |
| **7065**  | Retroactive seniority for claimants                                                                                                                                                                       |
| **7066**  | Complaint process                                                                                                                                                                                         |
| **7067**  | Manager assessment                                                                                                                                                                                        |
| **7068**  | Implement reforms in correctional and administrative practices                                                                                                                                            |
| **7069**  | Targeted killing                                                                                                                                                                                          |
| **7070**  | Adopt new redistricting plan                                                                                                                                                                              |
| **7071**  | Develop a new redistricting plan                                                                                                                                                                          |
| **7072**  | Notify impacted parties                                                                                                                                                                                   |
| **7073**  | Make changes to process for determining parole                                                                                                                                                            |
| **7074**  | Elimination of use of for-profit probation collection companies.                                                                                                                                          |
| **7075**  | Redistricting                                                                                                                                                                                             |
| **7076**  | Policies on appropriate conduct                                                                                                                                                                           |
| **7077**  | Record maintenance                                                                                                                                                                                        |
| **7078**  | Voter disenfranchisement                                                                                                                                                                                  |
| **7079**  | FOIA compliance                                                                                                                                                                                           |
| **7080**  | Amend health care policy on hernias                                                                                                                                                                       |
| **7081**  | Remove discriminatory filters                                                                                                                                                                             |
| **7082**  | Re-sentencing                                                                                                                                                                                             |
| **7083**  | Non-Consensual Human Experimentation                                                                                                                                                                      |
| **7084**  | Spending Clause                                                                                                                                                                                           |
| **7085**  | Plan for desegregation                                                                                                                                                                                    |
| **7086**  | Cease plans to create separate school district                                                                                                                                                            |
| **7087**  | Update Facilities                                                                                                                                                                                         |
| **7088**  | Mental Health Adminstration                                                                                                                                                                               |
| **7089**  | Prevention of retaliatory conduct                                                                                                                                                                         |
| **7090**  | Guidelines for judicial decisions                                                                                                                                                                         |
| **7091**  | Nationwide injunction                                                                                                                                                                                     |
| **7092**  | Agency interpretation forbidden                                                                                                                                                                           |
| **7093**  | Safe water                                                                                                                                                                                                |
| **7094**  | Environmental                                                                                                                                                                                             |
| **7095**  | Environmental                                                                                                                                                                                             |
| **7096**  | Environmental                                                                                                                                                                                             |
| **7097**  | Patient advocate                                                                                                                                                                                          |
| **7098**  | USA FREEDOM ACT Business Records                                                                                                                                                                          |
| **7099**  | 2016 Presidential Election Russian Interference                                                                                                                                                           |
| **7100**  | 7th amendment                                                                                                                                                                                             |
| **7101**  | Access to mental health evaluation                                                                                                                                                                        |
| **7102**  | Content of injunction: "Priority hiring consideration"                                                                                                                                                    |
| **7103**  | Right to privacy                                                                                                                                                                                          |
| **7104**  | Minimum Wage                                                                                                                                                                                              |
| **7105**  | Endangered species                                                                                                                                                                                        |
| **7106**  | Gang member cell assignment                                                                                                                                                                               |
| **7107**  | injunctive order to implement the concrete plan to open new jail                                                                                                                                          |
| **7108**  | Public defender caseload                                                                                                                                                                                  |
| **7109**  | United States Constitution, Art. II, § 2, cl. 2                                                                                                                                                           |
| **7110**  | Citizenship question                                                                                                                                                                                      |
| **7111**  | Take Care clause                                                                                                                                                                                          |
| **7112**  | Warrant Clause                                                                                                                                                                                            |
| **7113**  | Extortion                                                                                                                                                                                                 |
| **7114**  | Access to Medicaid Services                                                                                                                                                                               |
| **7115**  | Appropriations Clause                                                                                                                                                                                     |
| **7116**  | Medicaid                                                                                                                                                                                                  |
| **7117**  | Funding of Indigent Defense                                                                                                                                                                               |
| **7118**  | Content of Injunction: Attorney Compensation                                                                                                                                                              |
| **7119**  | Spending Clause                                                                                                                                                                                           |
| **7120**  | Appropriations Clause                                                                                                                                                                                     |
| **7121**  | Separation of Powers                                                                                                                                                                                      |
| **7122**  | Take Care Clause                                                                                                                                                                                          |
| **7123**  | Contracts Clause                                                                                                                                                                                          |
| **7124**  | Second Amendment                                                                                                                                                                                          |
| **7125**  | Separation of powers under Kansas law                                                                                                                                                                     |
| **7126**  | 24th Amendment                                                                                                                                                                                            |
| **7127**  | Twenty-Fourth Amendment                                                                                                                                                                                   |
| **7128**  | opioids                                                                                                                                                                                                   |
| **7129**  | Establishment Clause                                                                                                                                                                                      |
| **7130**  | Enumeration Clause                                                                                                                                                                                        |
| **7131**  | Additional relief came from sentencing criminal court                                                                                                                                                     |
| **7132**  | Separation of powers                                                                                                                                                                                      |
| **7133**  | Minimum wage                                                                                                                                                                                              |
| **7134**  | Postal Policy Changes Undermining Election                                                                                                                                                                |
| **7135**  | Postal Policy Changes Undermining State Efforts to Mitigate Spread of COVID-19                                                                                                                            |
| **7136**  | Michigan Constitution -- Nondelegation                                                                                                                                                                    |
| **7137**  | Spending Clause                                                                                                                                                                                           |
| **7138**  | Separation of Powers                                                                                                                                                                                      |
| **7139**  | Appointments Clause                                                                                                                                                                                       |
| **7140**  | COVID Education                                                                                                                                                                                           |
| **7141**  | mail delivery procedures                                                                                                                                                                                  |
| **7142**  | COVID-19 Aid for tribal governments                                                                                                                                                                       |
| **7143**  | Parole revocation hearings required                                                                                                                                                                       |
| **7144**  | Injunction-like agreement: Allow these plaintiffs to change their gender identity on their documents, but no one else.                                                                                    |
| **7145**  | Nondelegation Doctrine                                                                                                                                                                                    |
| **7146**  | Sexual harassment                                                                                                                                                                                         |
| **7147**  | Parole hearings - timeliness                                                                                                                                                                              |
| **7148**  | Termination of boot camp program                                                                                                                                                                          |
| **7149**  | Reverse Discrimination as a result of an affirmative action policy                                                                                                                                        |
| **7150**  | Recruitment practices favored male applicants                                                                                                                                                             |
| **7151**  | Voting rights for convicted felons                                                                                                                                                                        |
| **7152**  | Voting rights for convicted felons                                                                                                                                                                        |
| **7153**  | Felon voting disenfranchisement laws                                                                                                                                                                      |
| **7154**  | Felony voter disenfranchisement                                                                                                                                                                           |
| **7155**  | Giving Part time instead of full time employment based on pregnancy                                                                                                                                       |
| **7156**  | Justice of the Peace                                                                                                                                                                                      |
| **7157**  | Department of Social Services                                                                                                                                                                             |
| **7158**  | Voluntary depature process                                                                                                                                                                                |
| **7159**  | Unaccompanied minor aliens - rights                                                                                                                                                                       |
| **7160**  | Human Services                                                                                                                                                                                            |
| **7161**  | Airline                                                                                                                                                                                                   |
| **7162**  | Summary and ordinary exclusion proceedings                                                                                                                                                                |
| **7163**  | Certificates of identity for the Commonwealth of the Northern Mariana Islands                                                                                                                             |
| **7164**  | "Stop time" rule for suspension of deportation                                                                                                                                                            |
| **7165**  | Denial of Medicaid benefits, nonlegal permanent residents                                                                                                                                                 |
| **7166**  | Denial of Access                                                                                                                                                                                          |
| **7167**  | Lack of Oversight/ Monitoring                                                                                                                                                                             |
| **7168**  | Allocation of Funding Responsibility Between Counties and the State                                                                                                                                       |
| **7169**  | Allocation of Responsibility Between States and Counties/ Abdication of Responsibility by State                                                                                                           |
| **7170**  | Lack of Standards/ Oversight                                                                                                                                                                              |
| **7171**  | Access to Counsel                                                                                                                                                                                         |
| **7172**  | Pre-release planning                                                                                                                                                                                      |
| **7173**  | Failure to provide mental health care to parolees                                                                                                                                                         |
| **7174**  | Denial of SSI based on outstanding warrant                                                                                                                                                                |
| **7175**  | Suspension of SSI benefits to parolees                                                                                                                                                                    |
| **7176**  | Validity of newly established "Offices of the Criminal Conflict and Civil Regional Counsel" (OCCCRC) which fails to satisfy State Constitutional requirements for a public defender system                |
| **7177**  | Denial of Appointed Appellate Counsel for Certain Indigent Criminal Defendants who Pled Guilty                                                                                                            |
| **7178**  | Charging inmates for room and board                                                                                                                                                                       |
| **7179**  | “Pay-for-Stay” Program                                                                                                                                                                                    |
| **7180**  | non-consensual test for STDs                                                                                                                                                                              |
| **7181**  | Felon voting rights                                                                                                                                                                                       |
| **7182**  | Access to public FOIA documents without payment of retrieval fee                                                                                                                                          |
| **7183**  | Restaurant                                                                                                                                                                                                |
| **7184**  | blind accessibility                                                                                                                                                                                       |
| **7185**  | Failure to train or provide materials to inmate-trusties to enable safe clean-up of spilled blood                                                                                                         |
| **7186**  | Government Department, Department of State                                                                                                                                                                |
| **7187**  | Government Department, FDIC                                                                                                                                                                               |
| **7188**  | Constitutionality of the Voting Rights Act                                                                                                                                                                |
| **7189**  | inadequate emergency key provisions                                                                                                                                                                       |
| **7190**  | inadequte record keeping                                                                                                                                                                                  |
| **7191**  | Blind                                                                                                                                                                                                     |
| **7192**  | Web accessibility                                                                                                                                                                                         |
| **7193**  | Point of sale accessibility                                                                                                                                                                               |
| **7194**  | Discharge planning                                                                                                                                                                                        |
| **7195**  | Disability accessibility                                                                                                                                                                                  |
| **7196**  | Section 8                                                                                                                                                                                                 |
| **7197**  | Race discrimination                                                                                                                                                                                       |
| **7198**  | school desegregation                                                                                                                                                                                      |
| **7199**  | accommodations for students of limited English-speaking abilities                                                                                                                                         |
| **7200**  | Financial sector                                                                                                                                                                                          |
| **7201**  | jail funding                                                                                                                                                                                              |
| **7202**  | Assignment of counsel                                                                                                                                                                                     |
| **7203**  | Assignment of counsel                                                                                                                                                                                     |
| **7204**  | Assignment of counsel                                                                                                                                                                                     |
| **7205**  | provision of home-based services                                                                                                                                                                          |
| **7206**  | construction of a multi-service center for homeless persons                                                                                                                                               |
| **7207**  | Muslim head scarves                                                                                                                                                                                       |
| **7208**  | blind accessibility                                                                                                                                                                                       |
| **7209**  | blind accessibility                                                                                                                                                                                       |
| **7210**  | blind accessibility                                                                                                                                                                                       |
| **7211**  | disability access to buildings                                                                                                                                                                            |
| **7212**  | disability access to healthcare                                                                                                                                                                           |
| **7213**  | blind accessibility                                                                                                                                                                                       |
| **7214**  | blind accessibility                                                                                                                                                                                       |
| **7215**  | blind accessibility                                                                                                                                                                                       |
| **7216**  | blind accessibility                                                                                                                                                                                       |
| **7217**  | blind accessibility                                                                                                                                                                                       |
| **7218**  | blind accessibility                                                                                                                                                                                       |
| **7219**  | blind accessibility                                                                                                                                                                                       |
| **7220**  | blind accessibility                                                                                                                                                                                       |
| **7221**  | blind accessibility                                                                                                                                                                                       |
| **7222**  | blind accessibility                                                                                                                                                                                       |
| **7223**  | blind accessibility                                                                                                                                                                                       |
| **7224**  | blind accessibility                                                                                                                                                                                       |
| **7225**  | blind accessibility                                                                                                                                                                                       |
| **7226**  | blind accessibility                                                                                                                                                                                       |
| **7227**  | blind accessibility                                                                                                                                                                                       |
| **7228**  | blind accessibility                                                                                                                                                                                       |
| **7229**  | blind accessibility                                                                                                                                                                                       |
| **7230**  | blind accessibility                                                                                                                                                                                       |
| **7231**  | blind accessibility                                                                                                                                                                                       |
| **7232**  | search policies for homeless people                                                                                                                                                                       |
| **7233**  | Form Human Resource Committee                                                                                                                                                                             |
| **7234**  | Adult day care                                                                                                                                                                                            |
| **7235**  | Surveillance of police officers                                                                                                                                                                           |
| **7236**  | Eliminate use of ABT test in promotion decisions                                                                                                                                                          |
| **7237**  | Eliminate numerical weight-lifting requirement for hiring / promotion                                                                                                                                     |
| **7238**  | Hire HR Manager who must devote most of his her time to the Fairfield, Nashville site                                                                                                                     |
| **7239**  | notice                                                                                                                                                                                                    |
| **7240**  | extra-curricular services and activities                                                                                                                                                                  |
| **7241**  | due process hearings                                                                                                                                                                                      |
| **7242**  | new evidence                                                                                                                                                                                              |
| **7243**  | firing alleged harassers and preventing rehire                                                                                                                                                            |
| **7244**  | monetary relief                                                                                                                                                                                           |
| **7245**  | working condtions                                                                                                                                                                                         |
| **7246**  | Require the removal of customers who make unwelcome sexual advances to any employees                                                                                                                      |
| **7247**  | Racial Discrimination                                                                                                                                                                                     |
| **7248**  | Public Benefits for In-Home Supportive Services (IHSS) recipients                                                                                                                                         |
| **7249**  | Procedural Due Process                                                                                                                                                                                    |
| **7250**  | Provisions of ABX4 4                                                                                                                                                                                      |
| **7251**  | Appoint field diversity officer                                                                                                                                                                           |
| **7252**  | Distribute leads randomly, not based on gender                                                                                                                                                            |
| **7253**  | Create mentoring program for all female financial advisors                                                                                                                                                |
| **7254**  | Provide notification about maternity and child-rearing leave policies                                                                                                                                     |
| **7255**  | consent to jurisdiction of U.S. District Court for the Central District of CA for enforcement.                                                                                                            |
| **7256**  | Industrial Psychologist                                                                                                                                                                                   |
| **7257**  | Supremacy Clause                                                                                                                                                                                          |
| **7258**  | The "Federal Medical Assistance Percentage" (FMAP) of the Medicaid Act                                                                                                                                    |
| **7259**  | American Recovery and Reinvestment Act of 2009                                                                                                                                                            |
| **7260**  | Monetary awards for class members due to lost wages                                                                                                                                                       |
| **7261**  | Prisoner Wages                                                                                                                                                                                            |
| **7262**  | Prisoner publishing                                                                                                                                                                                       |
| **7263**  | Fifth Amendment Due Process; Bill of Attainder Clause                                                                                                                                                     |
| **7264**  | Raise of annual salary to $71,088 to match male counterparts                                                                                                                                              |
| **7265**  | U.S. Dept. of Justice as Amicus                                                                                                                                                                           |
| **7266**  | Modify sexual harassment policy                                                                                                                                                                           |
| **7267**  | Creation of Special Inspector office in the DC DOC to handle sexual complaints                                                                                                                            |
| **7268**  | Creation of the Sexual Harassment Advisory Committee                                                                                                                                                      |
| **7269**  | Disabled access to public transportation                                                                                                                                                                  |
| **7270**  | Retaliation                                                                                                                                                                                               |
| **7271**  | Prison conditions, failure to provide an interpreter                                                                                                                                                      |
| **7272**  | Trade Act of 1974                                                                                                                                                                                         |
| **7273**  | Fair Labor Standards                                                                                                                                                                                      |
| **7274**  | Relocating & raising prices on disabled seating                                                                                                                                                           |
| **7275**  | Removing & raising prices on disabled seating.                                                                                                                                                            |
| **7276**  | Defendant is a city                                                                                                                                                                                       |
| **7277**  | Disabled seating at concert venue                                                                                                                                                                         |
| **7278**  | allowing employees to speak Spanish                                                                                                                                                                       |
| **7279**  | Disabled access to business facilities                                                                                                                                                                    |
| **7280**  | Restaurant seating, parking, queue lines, bathrooms, etc.                                                                                                                                                 |
| **7281**  | Mandatory payment of union fees not related to bargaining                                                                                                                                                 |
| **7282**  | Curfew against children under 18                                                                                                                                                                          |
| **7283**  | Employ Industrial Psychologist and Diversity Training                                                                                                                                                     |
| **7284**  | Disparate Impact / Treatment                                                                                                                                                                              |
| **7285**  | Disparate impact / treatment                                                                                                                                                                              |
| **7286**  | Retaliatory discharge                                                                                                                                                                                     |
| **7287**  | establishment of employee/mangement diversity council                                                                                                                                                     |
| **7288**  | "African-American Railroader Month" to be celebrated on four anniversaries of the Consent Decree                                                                                                          |
| **7289**  | Defendant will name a major facility in honor of Dr. MLK Jr.                                                                                                                                              |
| **7290**  | establishment of mentoring program                                                                                                                                                                        |
| **7291**  | tuition reimbursement for skills training                                                                                                                                                                 |
| **7292**  | education and training program                                                                                                                                                                            |
| **7293**  | Injunction also requires defendant to hire a Diversity Monitor and an Industrial Psychologist to review policies                                                                                          |
| **7294**  | Injunction: One of out three hires must be minority candidates until 20 are hired in a hiring cycle. Effective until parity is achieved.                                                                  |
| **7295**  | Injunction: Develop an affirmative action program to recruit minority applicants                                                                                                                          |
| **7296**  | Injunction: Revise hiring examination so as to meet EEOC guidelines                                                                                                                                       |
| **7297**  | Injunction: Create a Diversity Committee                                                                                                                                                                  |
| **7298**  | Disciplinary Action for violations by supervisors and managers;                                                                                                                                           |
| **7299**  | Defendant Type: State Department                                                                                                                                                                          |
| **7300**  | Salary Adjustment                                                                                                                                                                                         |
| **7301**  | Back Pay Relief                                                                                                                                                                                           |
| **7302**  | Back Pay Relief                                                                                                                                                                                           |
| **7303**  | Press Release                                                                                                                                                                                             |
| **7304**  | Annual Survey                                                                                                                                                                                             |
| **7305**  | Void Releases under Older Workers Benefits Protection Act                                                                                                                                                 |
| **7306**  | Settlement agreement called for independent arbitrators to evaluate the claims of each individual class member.                                                                                           |
| **7307**  | Injunction: Defendant agreed to create three types of front of the house positions that would be gender neutral.                                                                                          |
| **7308**  | independent consultant for gender utilization analysis                                                                                                                                                    |
| **7309**  | reclassification upon request                                                                                                                                                                             |
| **7310**  | independent consultant to conduct compensation survey                                                                                                                                                     |
| **7311**  | training opportunities                                                                                                                                                                                    |
| **7312**  | supremacy over collective bargaining agreement                                                                                                                                                            |
| **7313**  | Elimination of "Special Skills Test"                                                                                                                                                                      |
| **7314**  | Preservation of and access to document though term of Decree                                                                                                                                              |
| **7315**  | Automatic union membership for class members with 6000 hours of experience (reversed on appeal)                                                                                                           |
| **7316**  | Permit class members with 3000 hours of experience to take the Journeyman Exam without class training                                                                                                     |
| **7317**  | Unnecessary Institutionalization                                                                                                                                                                          |
| **7318**  | Establishment of retirement account as if plaintiff had been hired                                                                                                                                        |
| **7319**  | Adjustments in salaries                                                                                                                                                                                   |
| **7320**  | Performance of Compensation Study                                                                                                                                                                         |
| **7321**  | Permission of class members to apply for Personal Service Contracts (PSCs) before the Agency advertises them to the public                                                                                |
| **7322**  | adopt mentoring program                                                                                                                                                                                   |
| **7323**  | develop mechanism to minimize fear of retaliation                                                                                                                                                         |
| **7324**  | Provide members with copies of the referral book if so requested.                                                                                                                                         |
| **7325**  | letter of reprimand to harasser                                                                                                                                                                           |
| **7326**  | harasser ineligible for pay raise, increase in benefits, transfer or promotion                                                                                                                            |
| **7327**  | Cancer treatment                                                                                                                                                                                          |
| **7328**  | The case concerns violations of the ADA (and related provisions of other laws) by homeless shelters in the District of Columbia                                                                           |
| **7329**  | Implementing Internal and External Disciplinary Tracking and Enhanced Performanced Evaluations                                                                                                            |
| **7330**  | discontinuation of screening test                                                                                                                                                                         |
| **7331**  | Note: The exact complaints made by the plaintiffs are not known.                                                                                                                                          |
| **7332**  | Case concerns mental health and the coverage of Therapeutic Behavioral Services                                                                                                                           |
| **7333**  | violation of First Amendment rights by political surveillance                                                                                                                                             |
| **7334**  | Clean Air Act Violations                                                                                                                                                                                  |
| **7335**  | Reached private, unpublished settlement                                                                                                                                                                   |
| **7336**  | involuntary institutionalization of persons with developmental disabilities and mental illness                                                                                                            |
| **7337**  | wait list for home/community-based services                                                                                                                                                               |
| **7338**  | access to services                                                                                                                                                                                        |
| **7339**  | Revamped the retirees health insurance coverage to be lawful under the ADEA                                                                                                                               |
| **7340**  | Developmentally Disabled                                                                                                                                                                                  |
| **7341**  | Developmentally Disabled                                                                                                                                                                                  |
| **7342**  | Developmentally Disabled                                                                                                                                                                                  |
| **7343**  | Developmentally Disabled                                                                                                                                                                                  |
| **7344**  | Developmentally Disabled                                                                                                                                                                                  |
| **7345**  | Developmentally Disabled                                                                                                                                                                                  |
| **7346**  | Unnecessary Institutionalization                                                                                                                                                                          |
| **7347**  | disability                                                                                                                                                                                                |
| **7348**  | Unnecessary Institutionalization                                                                                                                                                                          |
| **7349**  | censorship                                                                                                                                                                                                |
| **7350**  | lack of appeal                                                                                                                                                                                            |
| **7351**  | Developmentally Disabled                                                                                                                                                                                  |
| **7352**  | Public subsidies provided to transit users                                                                                                                                                                |
| **7353**  | access to public accomodations                                                                                                                                                                            |
| **7354**  | Access to Abortion                                                                                                                                                                                        |
| **7355**  | Taser use                                                                                                                                                                                                 |
| **7356**  | Policies related to restraint and treatment of women in labor.                                                                                                                                            |
| **7357**  | Search and Seizure                                                                                                                                                                                        |
| **7358**  | Racial Profiling                                                                                                                                                                                          |
| **7359**  | Equal Protection                                                                                                                                                                                          |
| **7360**  | Retaliation                                                                                                                                                                                               |
| **7361**  | Retaliation                                                                                                                                                                                               |
| **7362**  | Defamation                                                                                                                                                                                                |
| **7363**  | search assistance for suitable dwellings under the Section 8 Housing Choice Voucher program                                                                                                               |
| **7364**  | Para-Transit Availability                                                                                                                                                                                 |
| **7365**  | federal reconstruction funding                                                                                                                                                                            |
| **7366**  | whether the pre-termination evidentiary hearing is necessary to provide the welfare recipient with procedural due process                                                                                 |
| **7367**  | underpayment of minimum wages and overtime pay                                                                                                                                                            |
| **7368**  | Minnesota Supplemental Aid - the Special Diet Program                                                                                                                                                     |
| **7369**  | Breach of Contract in Surety and Cash Bonds                                                                                                                                                               |
| **7370**  | Work with approved consultant to review/revise existing policies                                                                                                                                          |
| **7371**  | Subsribing and Receiving Publications                                                                                                                                                                     |
| **7372**  | Wages for Overtime                                                                                                                                                                                        |
| **7373**  | Violation of the Prevailing Wage Act, New York Labor Law § 220                                                                                                                                            |
| **7374**  | Families with children treated differently than tenants without children.                                                                                                                                 |
| **7375**  | Race Baced Admissions Process                                                                                                                                                                             |
| **7376**  | felon dienfranchisement                                                                                                                                                                                   |
| **7377**  | Employment Discrimination                                                                                                                                                                                 |
| **7378**  | Disability Rights                                                                                                                                                                                         |
| **7379**  | Housing: Public Accommodation                                                                                                                                                                             |
| **7380**  | Housing: Public Accommodation                                                                                                                                                                             |
| **7381**  | Redevelopment                                                                                                                                                                                             |
| **7382**  | Procedural due process                                                                                                                                                                                    |
| **7383**  | Treatment for GID.                                                                                                                                                                                        |
| **7384**  | Provision of treatment for GID                                                                                                                                                                            |
| **7385**  | Confiscation of religious magazines                                                                                                                                                                       |
| **7386**  | backpay                                                                                                                                                                                                   |
| **7387**  | statement of intolerance of sexual harassment and retaliation                                                                                                                                             |
| **7388**  | assignment of Special Master                                                                                                                                                                              |
| **7389**  | curb ramps                                                                                                                                                                                                |
| **7390**  | access                                                                                                                                                                                                    |
| **7391**  | sexual harassment                                                                                                                                                                                         |
| **7392**  | new construction                                                                                                                                                                                          |
| **7393**  | right to shelter                                                                                                                                                                                          |
| **7394**  | prison conditions - segregation                                                                                                                                                                           |
| **7395**  | prison conditions - denial of services                                                                                                                                                                    |
| **7396**  | Professional Licensing                                                                                                                                                                                    |
| **7397**  | Administrative Procedures Act                                                                                                                                                                             |
| **7398**  | Administrative Procedures Act                                                                                                                                                                             |
| **7399**  | APA, Bivens                                                                                                                                                                                               |
| **7400**  | APA, Bivens                                                                                                                                                                                               |
| **7401**  | Racial discrimination                                                                                                                                                                                     |
| **7402**  | Marriage                                                                                                                                                                                                  |
| **7403**  | Marriage                                                                                                                                                                                                  |
| **7404**  | DOMA                                                                                                                                                                                                      |
| **7405**  | Federal Employee Health Benefits Program (FEHB)                                                                                                                                                           |
| **7406**  | Military Assignments                                                                                                                                                                                      |
| **7407**  | Social Security Income                                                                                                                                                                                    |
| **7408**  | California Welfare and Institutions Code 16500                                                                                                                                                            |
| **7409**  | Tenant Organization                                                                                                                                                                                       |
| **7410**  | Malicious Prosecution                                                                                                                                                                                     |
| **7411**  | First Amendment Rights                                                                                                                                                                                    |
| **7412**  | FAPE                                                                                                                                                                                                      |
| **7413**  | Federal Estate Tax                                                                                                                                                                                        |
| **7414**  | DOMA                                                                                                                                                                                                      |
| **7415**  | Capital punishment                                                                                                                                                                                        |
| **7416**  | Access of media                                                                                                                                                                                           |
| **7417**  | Access of media                                                                                                                                                                                           |
| **7418**  | Identification - validity of ID issued abroad                                                                                                                                                             |
| **7419**  | delegating law-making power to unelected emergency                                                                                                                                                        |
| **7420**  | Takings                                                                                                                                                                                                   |
| **7421**  | Takings                                                                                                                                                                                                   |
| **7422**  | Separation of Powers                                                                                                                                                                                      |
| **7423**  | Unreasonable search and seizure                                                                                                                                                                           |
| **7424**  | Drug testing                                                                                                                                                                                              |
| **7425**  | classification                                                                                                                                                                                            |
| **7426**  | suicide prevention policies                                                                                                                                                                               |
| **7427**  | mental health treatment                                                                                                                                                                                   |
| **7428**  | mental health assessment                                                                                                                                                                                  |
| **7429**  | limitation on use of solitary confinement                                                                                                                                                                 |
| **7430**  | Family Medical Leave Act (FMLA)                                                                                                                                                                           |
| **7431**  | ERISA-mandated qualified preretirement survivor annuity (QPSA)                                                                                                                                            |
| **7432**  | Defense of Marriage Act (DOMA)                                                                                                                                                                            |
| **7433**  | Defendant must correct housing violations.                                                                                                                                                                |
| **7434**  | Expansion of visitation rights                                                                                                                                                                            |
| **7435**  | Attorney fees for plaintiff                                                                                                                                                                               |
| **7436**  | Designation of liaison by Defendant                                                                                                                                                                       |
| **7437**  | Right to Read                                                                                                                                                                                             |
| **7438**  | video recording of confessions                                                                                                                                                                            |
| **7439**  | Defense of Marriage Act (DOMA)                                                                                                                                                                            |
| **7440**  | Permanent resident status                                                                                                                                                                                 |
| **7441**  | Drugs                                                                                                                                                                                                     |
| **7442**  | Pregnancy                                                                                                                                                                                                 |
| **7443**  | Lending goal of $425 million over 5 years for low and moderate income borrowers                                                                                                                           |
| **7444**  | Defendant enjoined from enforcing ordinance                                                                                                                                                               |
| **7445**  | debtors prison                                                                                                                                                                                            |
| **7446**  | Hispanic                                                                                                                                                                                                  |
| **7447**  | retrofitting                                                                                                                                                                                              |
| **7448**  | interference with sale to presumed African American                                                                                                                                                       |
| **7449**  | segregation of persons with disabilities in facility-based sheltered workshops                                                                                                                            |
| **7450**  | Pregnancy care                                                                                                                                                                                            |
| **7451**  | Seventeenth Amendment                                                                                                                                                                                     |
| **7452**  | Direct Election of Congress (Art. 1(2)                                                                                                                                                                    |
| **7453**  | Diabetes                                                                                                                                                                                                  |
| **7454**  | Medical diets                                                                                                                                                                                             |
| **7455**  | Chronic care                                                                                                                                                                                              |
| **7456**  | Juvenile assignment to geriatric nursing home                                                                                                                                                             |
| **7457**  | Audio Description Equipment                                                                                                                                                                               |
| **7458**  | Private company given quasi-judicial authority by the courts and the city                                                                                                                                 |
| **7459**  | Incarceration for inability to pay                                                                                                                                                                        |
| **7460**  | Condo association                                                                                                                                                                                         |
| **7461**  | Rules governing common areas                                                                                                                                                                              |
| **7462**  | Misclassification                                                                                                                                                                                         |
| **7463**  | Overtime pay                                                                                                                                                                                              |
| **7464**  | Provide proper treatment                                                                                                                                                                                  |
| **7465**  | Less restrictive alternatives                                                                                                                                                                             |
| **7466**  | Operate the program without purpose of punishment                                                                                                                                                         |
| **7467**  | Cease all alleged practices                                                                                                                                                                               |
| **7468**  | Means test                                                                                                                                                                                                |
| **7469**  | Access to birth control                                                                                                                                                                                   |
| **7470**  | Pepper spray                                                                                                                                                                                              |
| **7471**  | Management Information System                                                                                                                                                                             |
| **7472**  | This lawsuit was brought because the prior injunction was not being followed                                                                                                                              |
| **7473**  | provide additional grants to injured homeowners                                                                                                                                                           |
| **7474**  | Contracts Clause                                                                                                                                                                                          |
| **7475**  | Insurance                                                                                                                                                                                                 |
| **7476**  | military combat exclusion                                                                                                                                                                                 |
| **7477**  | Provide food, clothing, and shelter services                                                                                                                                                              |
| **7478**  | incontinence aids                                                                                                                                                                                         |
| **7479**  | Payment device                                                                                                                                                                                            |
| **7480**  | waiver services                                                                                                                                                                                           |
| **7481**  | service reimbursement rates                                                                                                                                                                               |
| **7482**  | Credit card reader access                                                                                                                                                                                 |
| **7483**  | Enjoin enforcement of contraception coverage in the ACA                                                                                                                                                   |
| **7484**  | Partial injunction: Law enforcement officers cannot conduct stops based solely on the knowledge or belief that a person is unlawfully in the country                                                      |
| **7485**  | Video and audio reporting of all traffic stops                                                                                                                                                            |
| **7486**  | No use of canines for routine traffic stops                                                                                                                                                               |
| **7487**  | Written notice prior to a canine sniff, consent search, or seizure of property. Written and oral video and audio recorded consent searches.                                                               |
| **7488**  | Track all assets obtained from forfeiture and donate or use it for compliance with the decree.                                                                                                            |
| **7489**  | Separatio of Powers / Impermissible delegation of legislative authority to the Executive Branch                                                                                                           |
| **7490**  | Separation of Powers / Impermissible delegation of legislative authority to the Executive Branch                                                                                                          |
| **7491**  | Cannot host weddings in the future                                                                                                                                                                        |
| **7492**  | Provide parental participation in IEP development                                                                                                                                                         |
| **7493**  | Bans single sex classes unless certain prerequisites are met.                                                                                                                                             |
| **7494**  | Enjoined from implementing or enforcing state penal code sections at issue                                                                                                                                |
| **7495**  | Wheelchair seating in a stadium                                                                                                                                                                           |
| **7496**  | Injunction against parade permitting ordinance.                                                                                                                                                           |
| **7497**  | Ban on recording police.                                                                                                                                                                                  |
| **7498**  | 2-wheeled upright electric mobility devices (Segway PT)                                                                                                                                                   |
| **7499**  | Bans enforcement of anti-begging statute permanently.                                                                                                                                                     |
| **7500**  | Injunction to keep hospital open; closing would have discriminatory impact on public benefit distribution based on disability                                                                             |
| **7501**  | Bans university policy that prohibits organizations to limit membership.                                                                                                                                  |
| **7502**  | Access to Voter Registration Information                                                                                                                                                                  |
| **7503**  | Digital scanning of library collections as an accommodation for blind patrons, under the ADA and the Copyright Act                                                                                        |
| **7504**  | Creation and maintaining a Diversity and Inclusion Council for advisory purposes                                                                                                                          |
| **7505**  | Curb cuts / curb ramps                                                                                                                                                                                    |
| **7506**  | Curb cuts / curb ramps                                                                                                                                                                                    |
| **7507**  | Curb cuts / curb ramps                                                                                                                                                                                    |
| **7508**  | Partnering with organizations dedicated to the advancement and well-being of African Americans and other minorities and notifying such partners when job openings are posted                              |
| **7509**  | Failure to accomodate side-effects of chemotherapy and surgery in the course of cancer treatment                                                                                                          |
| **7510**  | Curb cuts / curb ramps                                                                                                                                                                                    |
| **7511**  | Accessibility of movie theaters to blind and/or deaf patrons                                                                                                                                              |
| **7512**  | Digital scanning of books and library collections as an accommodation for blind patrons, under the ADA and the Copyright Act                                                                              |
| **7513**  | Detention of and access to representation by immigrants with mental disabilities or mental health issues                                                                                                  |
| **7514**  | Preventing institutionalization of disabled individuals with conditions not likely to improve with treatment                                                                                              |
| **7515**  | Settlement content: State shall appoint counsel whenever a conditional discharge from mental health facility is revoked                                                                                   |
| **7516**  | Medicaid Home and Community-Based Services waiver recipient access to community based group houses                                                                                                        |
| **7517**  | Private suit to compel federal agency to ensure State compliance with its programs                                                                                                                        |
| **7518**  | Veterans' benefits for same-sex spouses                                                                                                                                                                   |
| **7519**  | Public sleeping ban                                                                                                                                                                                       |
| **7520**  | Sealing or expungement of records relating to violation of allegedly unconstitutionally discriminatory ordinance                                                                                          |
| **7521**  | Veterans benefits for spouses in same-sex marriage                                                                                                                                                        |
| **7522**  | Accessibility of Point-of-sale (POS) terminals                                                                                                                                                            |
| **7523**  | Increase bus service and freeze prices for public transportation                                                                                                                                          |
| **7524**  | Compliance Coordinator                                                                                                                                                                                    |
| **7525**  | Development of policies to ensure only reasonable use of force, seclusion, and restraints                                                                                                                 |
| **7526**  | Development of policies to ensure adequate mental health care                                                                                                                                             |
| **7527**  | Development of policies to ensure adequate special education                                                                                                                                              |
| **7528**  | Provision of adequate programs                                                                                                                                                                            |
| **7529**  | Display of speech on the exterior of mass transit vehicles.                                                                                                                                               |
| **7530**  | City raiding encampments of homeless individuals and seizing and immediately destroying their personal property.                                                                                          |
| **7531**  | Censorship                                                                                                                                                                                                |
| **7532**  | Bans the university's prior notice and location requirements for on-campus expressive activities.                                                                                                         |
| **7533**  | reduction in reimbursement rate paid to Medicaid providers                                                                                                                                                |
| **7534**  | Campaign contribution                                                                                                                                                                                     |
| **7535**  | State's failure to meet its obligations under the Adoption Assistance and Child Welfare Act of 1980                                                                                                       |
| **7536**  | Detention of U.S. citizen                                                                                                                                                                                 |
| **7537**  | Train police in the new policy dealing with street musicians.                                                                                                                                             |
| **7538**  | Institution Closing                                                                                                                                                                                       |
| **7539**  | Implementation of pilot program                                                                                                                                                                           |
| **7540**  | Surveillance and harassment                                                                                                                                                                               |
| **7541**  | Bans future surveillance or harassment of the plaintiffs.                                                                                                                                                 |
| **7542**  | Failure to comply with earlier settlement controlling crowd dispersal                                                                                                                                     |
| **7543**  | Forced pregnancy testing of unlawfully detained demonstrators.                                                                                                                                            |
| **7544**  | Providing enough time at meals for inmates who are observant Muslim to pray.                                                                                                                              |
| **7545**  | Use of excessive force to disperse demonstrators in contravention of city police determined by earlier settlement.                                                                                        |
| **7546**  | Establishment of Crowd Control Policy forbidding dispersal of crowds not representing an imminent threat or behaving illegally, and forbidding use of excessive force/less lethal weapons against crowds. |
| **7547**  | Investigate                                                                                                                                                                                               |
| **7548**  | Waiver of right to file a charge with EEOC and participate in its investigation                                                                                                                           |
| **7549**  | Develop a harassment policy                                                                                                                                                                               |
| **7550**  | Reduction in State's rate of pay for in-home caregivers under Medicare.                                                                                                                                   |
| **7551**  | detailed job descriptions                                                                                                                                                                                 |
| **7552**  | objective criteria                                                                                                                                                                                        |
| **7553**  | develop use of force policy                                                                                                                                                                               |
| **11005** | Vaccine Accessibility                                                                                                                                                                                     |
| **11026** | Government Services, equal access to policing                                                                                                                                                             |
| **11034** | Public water service                                                                                                                                                                                      |
| **11057** | Vaccine Accessibility                                                                                                                                                                                     |
| **11058** | Vaccine Accessibility                                                                                                                                                                                     |
| **11059** | FOIA response                                                                                                                                                                                             |
| **11065** | Juvenile life sentences                                                                                                                                                                                   |
| **11066** | COVID-19 Vaccination Mandate                                                                                                                                                                              |
| **11067** | Abortion provider medical malpractice coverage                                                                                                                                                            |

For more information about custom case issues, see [Issues](/api-reference-v2p1/objects/case/issues#custom_issues).

**Example**

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

```
https://clearinghouse.net/api/v2p1/case?custom_issues=11067
```

{% endtab %}

{% tab title="python" %}

```
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Appellate Court Litigation Status

Filter cases by appellate court litigation status ID (integer).

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

### Filter by appellate court litigation status ID (integer).

### Supported values (\```appellate_court_litigation_status_id`)``

Supported appellate court litigation statuses (`appellate_court_litigation_status_id`):

| 38904 | Appeal Dismissed                                    |
| ----- | --------------------------------------------------- |
| 38871 | Appeal Pending                                      |
| 38874 | Affirmed                                            |
| 38873 | Appellate Stay of Trial Court Relief Denied         |
| 38872 | Appellate Stay of Trial Court Relief Granted        |
| 38905 | Case Dismissed on Appeal                            |
| 38906 | Pending in Supreme Court                            |
| 38875 | Reversed                                            |
| 38962 | Supreme Court Granted Stay of Removal               |
| 38922 | Supreme Court Stay of Trial Court Relief Denied     |
| 38921 | apiSupreme Court Stay of Trial Court Relief Granted |

### 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> |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?appellate_court_litigation_status=38871
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Trial Court Litigation Status

## Get cases by trial court litigation status ID (integer)

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

### 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> |

Supported trial court litigation statuses (`trial_court_litigation_status_id`):

| 38866 | Administrative Stay Granted                              |
| ----- | -------------------------------------------------------- |
| 38975 | Administrative Matter Ongoing                            |
| 39003 | Administrative Matter Closed                             |
| 38871 | Appeal Pending *(see Appellate Court Litigation Status)* |
| 38870 | Case Is Ongoing                                          |
| 38902 | Case Dismissed (Involuntary)                             |
| 38983 | Case Dismissed (Voluntary)                               |
| 38925 | Case Transferred: Docket Closed                          |
| 38907 | Consolidated: Docket Closed                              |
| 38924 | Injunction Granted                                       |
| 38989 | Judgment for Defendant                                   |
| 38988 | Judgment for Plaintiff                                   |
| 38865 | Motion for Emergency or Preliminary Relief Pending       |
| 38903 | Preliminary Injunction Denied                            |
| 38868 | Preliminary Injunction Granted                           |
| 38984 | Preliminary Injunction Granted, but Stayed               |
| 38966 | Settled: Case Closed                                     |
| 38965 | Settled: Implementation Ongoing                          |
| 38867 | Temporary Restraining Order Granted                      |
| 38869 | Temporary Restraining Order Denied                       |
| 38959 | Habeas Relief Granted                                    |

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?trial_court_litigation_status=38870
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Filing date

Get cases by filing date range.

Use `filing_date_from` and/or `filing_date_to` to filter cases by the Both parameters accept dates in `YYYY-MM-DD` format. Either or both parameters may be provided.

### filing\_date\_from

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases/?filing_date_from=YYYY-MM-DD`

Returns all cases with a filing date **on or after** the given date.

### filing\_date\_to

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases/?filing_date_to=YYYY-MM-DD`

Returns all cases with a filing date **on or before** the given date.

### 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> |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?filing_date_from=2020-01-01&filing_date_to=2020-12-31
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/cases?filing_date_from=2020-01-01&filing_date_to=2020-12-31"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Filing year

### Get cases by filing year (integer).

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

Returns all cases filed in the given year. Matches cases where the full `filing_date` falls within that year, as well as cases where only the `filing_year` matches.

#### 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> |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?filing_year=2010
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Name

Filter cases by their names.

## Get cases by name (case-insensitive text search).

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

### 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> |

### Example

The following will search for all cases with United States in their case names.

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

```
https://clearinghouse.net/api/v2p1/cases?name=United+States
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Plaintiff Description

### Get cases by plaintiff description (case-insensitive text search).

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

### 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> |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?plaintiff_description=immigrant
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Relief Sought

### Get cases by relief sought ID (integer).

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

### 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> |

### Supported relief sought values (\`relief\_sought\_id\`)

| 39073 | Attorneys fees                      |
| ----- | ----------------------------------- |
| 39085 | Criminal conviction                 |
| 39074 | Damages                             |
| 39075 | Declaratory judgment                |
| 39076 | Document/Information                |
| 39077 | Habeas                              |
| 39078 | Injunction                          |
| 39116 | Receivership                        |
| 39079 | Stay of proceedings                 |
| 39130 | Stay of government action           |
| 39129 | Stay of injunction                  |
| 39080 | Warrant/Order allowing surveillance |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?relief_sought=39078
```

{% endtab %}

{% tab title="python" %}

```python
import requests

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

print(response.text)
```

{% endtab %}
{% endtabs %}


# Settlement Judgement Date

Get cases by settlement or judgment date range.

Use `settlement_judgment_date_from` and/or `settlement_judgment_date_to` to filter cases by the Both parameters accept dates in `YYYY-MM-DD` format. Either or both parameters may be provided.

### settlement\_judgement\_date\_from

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases/?settlement_judgement_date_from=YYYY-MM-DD`

Returns all cases with a filing date **on or after** the given date.

### settlement\_judgement\_date\_to

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases/?settlement_judgement_date_to=YYYY-MM-DD`

Returns all cases with a filing date **on or before** the given date.

### 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> |

### Example

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

```
https://clearinghouse.net/api/v2p1/cases?settlement_judgement_date_from=2020-01-01&settlement_judgement_date_to=2020-12-31
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/cases?filing_date_from=2020-01-01&filing_date_to=2020-12-31"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Summary Author

### Get cases by summary author (name search or author ID).

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

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

This parameter accepts either a **name string** or a **numeric author ID**.

**Name search:** Provide one or more space-separated name tokens. Each token is matched case-insensitively against both the first and last name of summary authors. All tokens must match (AND logic), so more tokens narrow the results.

**ID search:** If the value is a numeric integer, it is interpreted as the author's ID and an exact match is performed.

### Example

{% tabs %}
{% tab title="URL — name search (one token)" %}

```
https://clearinghouse.net/api/v2p1/cases?summary_author=schlanger
```

{% endtab %}

{% tab title="URL -- name search (Multiple tokens)" %}

```
https://clearinghouse.net/api/v2p1/cases?summary_author=margo+schlanger
```

{% endtab %}

{% tab title="URL — ID search" %}

```
https://clearinghouse.net/api/v2p1/cases?summary_author=21900
```

{% endtab %}

{% tab title="python" %}

```python
import requests

# Name search
url = "https://clearinghouse.net/api/v2p1/cases?summary_author=schlanger+margo"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Terminating Date

### Get cases by terminating date range

Use `terminating_date_from` and/or `terminating_date_to` to filter cases by their terminating date. Both parameters accept dates in `YYYY-MM-DD` format. Either or both parameters may be provided; when used together they define an inclusive range.

### terminating\_date\_from

<mark style="color:blue;">`GET`</mark> `https://clearinghouse.net/api/v2p1/cases/?terminating_date_from=YYYY-MM-DD`

Returns all cases with a terminating date **on or after** the given date.

### terminating\_date\_to

Returns all cases with a terminating date **on or before** the given date.

### 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> |

### Example&#x20;

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

```
https://clearinghouse.net/api/v2p1/cases?terminating_date_from=2018-01-01&terminating_date_to=2018-12-31
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/cases?terminating_date_from=2018-01-01&terminating_date_to=2018-12-31"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Case Text Search

### Get cases by full-text search (string).

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

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

```
\\ No results
\\ Example query endpoint: /api/v2p1/cases/?text=zzznomatch
["No results for {'text': 'zzznomatch'}"]

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

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

Returns all cases that have at least one document matching the search query. Note: this search uses the same index as the [Document text search](/api-reference-v2p1/endpoints/documents#text-search). Searching cases by `text` returns cases that have at least one document matching the query. Search is powered by PostgreSQL full-text search and runs across the following fields, in descending order of relevance weight:

| Field          | Weight      |
| -------------- | ----------- |
| Case name      | A (highest) |
| Document title | B           |
| Case summary   | C           |
| Document text  | D (lowest)  |

Queries are matched using PostgreSQL's `SearchQuery`, which supports natural language stemming (e.g. "running" matches "run"). Multi-word queries are treated as AND by default — all terms must appear somewhere across the searched fields.

**Example**

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

```
https://clearinghouse.net/api/v2p1/cases?text=solitary+confinement
```

{% endtab %}

{% tab title="python" %}

```python
import requests

url = "https://clearinghouse.net/api/v2p1/cases?text=solitary+confinement"
headers = { 'Authorization': 'Token XXXXXXXXXX',
'User-Agent': 'Chrome v22.2 Linux Ubuntu'
}
response = requests.request("GET", url, headers=headers, data={})

print(response.text)
```

{% endtab %}
{% endtabs %}


# Objects


# Case

Each endpoint returns a list of cases, where each case is a JSON dictionary.

Because cases in the Clearinghouse are being added and updated all the time, the `case_status` of a case is useful for understanding why some fields might be empty. For more information on the different statuses, see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

<details>

<summary>Example: a completely blank case</summary>

```javascript
{
  "count": 0,
  "next": null,
  "previous": null,
  "results": [
    {
      "attorney_orgs": [],
      "available_documents": [],
      "case_defendants": [],
      "case_ongoing": "",
      "case_status": "",
      "case_types": [],
      "cause_other": "",
      "causes": [],
      "class_action_granted": "",
      "class_action_sought": "",
      "closing_year": null,
      "constitutional_clause": [],
      "content_of_injunction": [
        {
          "value": ""
        },
      ],
      "court": "",
      "custom_issues": [],
      "defendant_payment": "",
      "defendant_type": [
        {
          "value": ""
        }],
      "docket_status": "",
      "facility_type": [],
      "filing_date": "",
      "filing_year": null,
      "id": 0,
      "injunction_duration": "",
      "issues": [],
      "last_checked_date": "",
      "main_docket": {
        "id": 0,
        "docket_entries": [
          {
            "row_number": null,
            "id": 0,
            "entry_number": "",
            "date_filed": "",
            "attachments": [],
            "url": "",
            "recap_pdf_url": null,
            "pacer_doc_id": "",
            "description": ""
          }
        ],
        "docket_case_type": "",
        "docket_year": null,
        "docket_filing_number": null,
        "is_main_docket": true,
        "court": "",
        "state": "",
        "docket_office_number": "",
        "docket_number_manual": "",
        "scales_html": "",
        "recap_link": "",
        "is_active": true
      },
      "name": "",
      "never_filed": false,
      "non_docket_case_number": "",
      "non_docket_case_number_type": "",
      "non_docket_case_number_type_other": "",
      "order_end_year": null,
      "order_start_year": null,
      "permanent_injunction": false,
      "plaintiff_description": "",
      "plaintiff_type": [
        {
          "value": ""
        }],
      "prevailing_party": "",
      "pro_se_status": "",
      "public_interest_lawyer": "",
      "related_cases": [],
      "relief_natures": [],
      "relief_nature_other": "",
      "relief_sources": [],
      "settlement_agreement": [],
      "settlement_judgment_date": "",
      "settlement_judgment_year": null,
      "special_collections": [],
      "special_case_type": [],
      "state": "",
      "summary": "",
      "summary_published_date": "",
      "summary_short": "",
      "summary_tiny": null,
      "terminating_date": null,
      "clearinghouse_link": "",
      "is_active": true,
      "case_documents_url": "",
      "case_dockets_url": "",
      "case_resources_url": ""
    }
  ]
}
```

</details>

For more information:

| Field                                  | Type           | Documentation (link)                                                                                                                                                                                                                                                 |
| -------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| attorney\_orgs                         | array\[string] | [Parties](/api-reference-v2p1/objects/case/parties#attorney_orgs)                                                                                                                                                                                                    |
| available\_documents                   | array\[string] | [Documents](/api-reference-v2p1/objects/case/documents#available_documents)                                                                                                                                                                                          |
| case\_defendants                       | array\[object] | [Parties](/api-reference-v2p1/objects/case/parties#case_defendants)                                                                                                                                                                                                  |
| case\_ongoing                          | string         | [Case Details](/api-reference-v2p1/objects/case/case-details#case_ongoing)                                                                                                                                                                                           |
| case\_status                           | string         | [Case Status](/api-reference-v2p1/objects/case/case-status#case_status)                                                                                                                                                                                              |
| case\_types                            | array\[string] | [Case Details](/api-reference-v2p1/objects/case/case-details#case_types)                                                                                                                                                                                             |
| cause\_other                           | string         | [Causes of Action](/api-reference-v2p1/objects/case/causes-of-action#cause_other)                                                                                                                                                                                    |
| causes                                 | array\[string] | [Causes of Action](/api-reference-v2p1/objects/case/causes-of-action#causes)                                                                                                                                                                                         |
| class\_action\_granted                 | string         | [Parties](/api-reference-v2p1/objects/case/parties#class_action_granted)                                                                                                                                                                                             |
| class\_action\_sought                  | string         | [Parties](/api-reference-v2p1/objects/case/parties#class_action_sought)                                                                                                                                                                                              |
| closing\_year                          | number         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#closing_year)                                                                                                                                                                                                 |
| court                                  | string         | [Case Details](/api-reference-v2p1/objects/case/case-details#court)                                                                                                                                                                                                  |
| custom\_issues                         | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#custom_issues)                                                                                                                                                                                                      |
| defendant\_payment                     | string         | [Outcome](/api-reference-v2p1/objects/case/outcome#defendant_payment)                                                                                                                                                                                                |
| docket\_status                         | string         | [Case Status](/api-reference-v2p1/objects/case/case-status#docket_status)                                                                                                                                                                                            |
| filing\_date                           | string         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#filing_date)                                                                                                                                                                                                  |
| filing\_year                           | number         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#filing_year)                                                                                                                                                                                                  |
| id                                     | number         | [Case Details](/api-reference-v2p1/objects/case/case-details#id)                                                                                                                                                                                                     |
| injunction\_duration                   | string         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#injunction_duration)                                                                                                                                                                                          |
| issues                                 | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#issues)                                                                                                                                                                                                             |
| last\_checked\_date                    | string         | [Case Status](/api-reference-v2p1/objects/case/case-status#last_checked_date)                                                                                                                                                                                        |
| name                                   | string         | [Case Details](/api-reference-v2p1/objects/case/case-details#name)                                                                                                                                                                                                   |
| never\_filed                           | boolean        | [Key Dates](/api-reference-v2p1/objects/case/key-dates#never_filed)                                                                                                                                                                                                  |
| non\_docket\_case\_number              | string         | [Dockets and Case Numbers](/api-reference-v2p1/objects/case/dockets#non_docket_case_number)                                                                                                                                                                          |
| non\_docket\_case\_number\_type        | string         | [Dockets and Case Numbers](/api-reference-v2p1/objects/case/dockets#non_docket_case_number_type)                                                                                                                                                                     |
| non\_docket\_case\_number\_type\_other | string         | [Dockets and Case Numbers](/api-reference-v2p1/objects/case/dockets#non_docket_case_number_type_other)                                                                                                                                                               |
| order\_end\_year                       | number         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#order_end_year)                                                                                                                                                                                               |
| order\_start\_year                     | number         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#order_start_year)                                                                                                                                                                                             |
| permanent\_injunction                  | boolean        | [Key Dates](/api-reference-v2p1/objects/case/key-dates#permanent_injunction)                                                                                                                                                                                         |
| plaintiff\_description                 | string         | [Parties](/api-reference-v2p1/objects/case/parties#plaintiff_description)                                                                                                                                                                                            |
| prevailing\_party                      | string         | [Outcome](/api-reference-v2p1/objects/case/outcome#prevailing_party)                                                                                                                                                                                                 |
| pro\_se\_status                        | string         | [Parties](/api-reference-v2p1/objects/case/parties#pro_se_status)                                                                                                                                                                                                    |
| public\_interest\_lawyer               | string         | [Parties](/api-reference-v2p1/objects/case/parties#public_interest_lawyer)                                                                                                                                                                                           |
| relief\_natures                        | array\[string] | [Outcome](/api-reference-v2p1/objects/case/outcome#relief_natures)                                                                                                                                                                                                   |
| relief\_nature\_other                  | string         | [Outcome](/api-reference-v2p1/objects/case/outcome#relief_nature_other)                                                                                                                                                                                              |
| relief\_sources                        | array\[string] | [Outcome](/api-reference-v2p1/objects/case/outcome#relief_sources)                                                                                                                                                                                                   |
| settlement\_agreement                  | array\[string] | [Outcome](/api-reference-v2p1/objects/case/outcome#settlement_agreement)                                                                                                                                                                                             |
| settlement\_judgment\_date             | string         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#settlement_judgment_date)                                                                                                                                                                                     |
| settlement\_judgment\_year             | number         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#settlement_judgment_year)                                                                                                                                                                                     |
| special\_collections                   | array\[string] | [Case Details](/api-reference-v2p1/objects/case/case-details#special_collections)                                                                                                                                                                                    |
| state                                  | string         | [Case Details](/api-reference-v2p1/objects/case/case-details#state)                                                                                                                                                                                                  |
| summary                                | string         | [Summaries](/api-reference-v2p1/objects/case/summaries#summary)                                                                                                                                                                                                      |
| summary\_published\_date               | string         | [Summaries](/api-reference-v2p1/objects/case/summaries#summary_published_date)                                                                                                                                                                                       |
| summary\_short                         | string         | [Summaries](/api-reference-v2p1/objects/case/summaries#summary_short)                                                                                                                                                                                                |
| summary\_tiny                          | string         | [Summaries](/api-reference-v2p1/objects/case/summaries#summary_tiny)                                                                                                                                                                                                 |
| terminating\_date                      | string         | [Key Dates](/api-reference-v2p1/objects/case/key-dates#terminating_date)                                                                                                                                                                                             |
| clearinghouse\_link                    | string         | [Case Details](/api-reference-v2p1/objects/case/case-details#clearinghouse_link)                                                                                                                                                                                     |
| is\_active                             | boolean        | [Case Status](/api-reference-v2p1/objects/case/case-status#is_active)                                                                                                                                                                                                |
| plaintiff\_type                        | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#plaintiff_type)                                                                                                                                                                                                     |
| defendant\_type                        | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#defendant_type)                                                                                                                                                                                                     |
| facility\_type                         | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#facility_type)                                                                                                                                                                                                      |
| constitutional\_clause                 | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#constitutional_clause)                                                                                                                                                                                              |
| special\_case\_type                    | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#special_case_type)                                                                                                                                                                                                  |
| content\_of\_injunction                | array\[string] | [Issues](/api-reference-v2p1/objects/case/issues#content_of_injunction)                                                                                                                                                                                              |
| case\_documents\_url                   | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case\_documents\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case_documents_url "mention") |
| case\_dockets\_url                     | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case\_dockets\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case_dockets_url "mention")     |
| case\_resources\_url                   | array\[string] | [https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case\_resources\_url](https://github.com/CRClearinghouse/CRLCA/blob/master/api-reference-v2p1/objects/case/pagination-urls.md#case_resources_url "mention") |


# Case Details

## id

(*number*)

The case's ID. Each case's ID is unique.

## clearinghouse\_link

(*string*)

The URL to the case on the [Clearinghouse site](https://clearinghouse.net), which takes the format `"clearinghouse.net/case/{id}"`.

## name

(*string*)

The name of the case. Although a case's name may change as the case progresses, we generally do not update this field.

## state

(*string*)

The state in which the case happens. This is typically a U.S. state, but other possible values for this field are U.S. territories, the District of Columbia, `"- International -"`, `"- United States (national) -"`, and `"Other"`.

Typically cases occur all in one state, but if a case entry concerns litigation that happens in multiple states, `state` will be the main state of the case. In cases where there are appeals to courts that cover multiple states (e.g. the Supreme Court of the United States), `state` is the state where the case originated.

<details>

<summary>Full list of states</summary>

* \- International -
* \- United States (national) -
* Alabama
* Alaska
* American Samoa
* Arizona
* Arkansas
* California
* Colorado
* Connecticut
* Delaware
* District of Columbia
* Federated States of Micronesia
* Florida
* Georgia
* Guam
* Hawaii
* Idaho
* Illinois
* Indiana
* Iowa
* Kansas
* Kentucky
* Louisiana
* Maine
* Marshall Islands
* Maryland
* Massachusetts
* Michigan
* Minnesota
* Mississippi
* Missouri
* Montana
* Nebraska
* Nevada
* New Hampshire
* New Jersey
* New Mexico
* New York
* North Carolina
* North Dakota
* Northern Mariana Islands
* Ohio
* Oklahoma
* Oregon
* Palau
* Pennsylvania
* Puerto Rico
* Rhode Island
* South Carolina
* South Dakota
* Tennessee
* Texas
* Utah
* Vermont
* Virgin Islands
* Virginia
* Washington
* West Virginia
* Wisconsin
* Wyoming
* Other

</details>

## court

(*string*)

The court where a case starts. If a case entry concerns litigation that happens in multiple courts (e.g. appeals, consolidations), `court` remains the first court relevant to the case.

There are several types of courts:

| Type                                        | Example(s)                                                                                                                                                                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| no court                                    | No Court                                                                                                                                                                                                                                                   | This is for cases where no court was involved, e.g. private out-of-court settlements, U.S. Department of Justice investigations                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| state courts                                | <ul><li>Michigan state trial court</li><li>Ohio state appellate court</li><li>New York state supreme court</li></ul>                                                                                                                                       | <p>Courts part of a state's judicial system. If a case's court is a state court, it must be a court associated with <code>state</code>.</p><p>Because each state has its own way of organizing courts, we have three generic options for each state: trial court, appellate court, and supreme court. Trial courts are the courts where cases typically start, appellate courts hear cases on appeal, and the supreme court is the highest court in the state.<br><br>Note: These do NOT necessarily correspond to the names of the courts. For example, <code>"New York state supreme court"</code> refers to the New York Court of Appeals, while <code>"New York state trial court"</code> refers to the New York Supreme Courts.</p> |
| U.S. district courts                        | <ul><li>District of Massachusetts</li><li>District of Columbia</li><li>Western District of Washington</li><li>Northern District of Illinois</li><li>District Court for the Northern Mariana Islands</li><li>District Court of the Virgin Islands</li></ul> | <p>The trial courts of the U.S. federal judicial system. Each judicial district covers one U.S. state or one portion of a state. There is at least one judicial district for each state, the District of Columbia, Puerto Rico, Guam, the Northern Mariana Islands, and the Virgin Islands.<br><br>If a case's court is a U.S. district court, it must be a court associated with <code>state</code>.</p>                                                                                                                                                                                                                                                                                                                                |
| U.S. appellate courts                       | <ul><li>U. S. Court of Appeals for the First Circuit</li><li>U. S. Court of Appeals for the District of Columbia Circuit</li><li>U. S. Court of Appeals for the Federal Circuit</li></ul>                                                                  | <p>The intermediate courts of the U.S. federal judicial system. The courts of appeal are divided into 11 numbered circuits, each of which covers multiple states. In addition, there are circuits for the District of Columbia and the Federal Circuit.<br></p><p>If a case's court is a U.S. appellate court, it must be a court associated with <code>state</code>.<br></p><p>Note: The space between "U." and "S." is a typo that may be fixed in a future update.</p>                                                                                                                                                                                                                                                                |
| U.S. Supreme Court                          | Supreme Court of the United States                                                                                                                                                                                                                         | The highest court in the U.S. federal judicial system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| specialty courts (FISA)                     | <ul><li>Foreign Intelligence Surveillance Court</li><li>Foreign Intelligence Surveillance Court of Review</li></ul>                                                                                                                                        | The Foreign Intelligence Surveillance Act of 1978 (FISA) established these courts to oversee government requests for foreign intelligence surveillance warrants by federal law enforcement agencies.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| specialty courts (international trade)      | U. S. Court of International Trade                                                                                                                                                                                                                         | This court is for civil cases arising out of U.S. customs and international trade laws.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| specialty courts (veterans claims)          | U.S. Court of Appeals for Veterans Claims                                                                                                                                                                                                                  | This court receives appeals of decisions by the Board of Veterans' Appeals. This court is part of the U.S. federal judicial system and not part of the Department of Veteran Affairs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| specialty courts (multidistrict litigation) | U.S. Judicial Panel on Multidistrict Litigation (JPML)                                                                                                                                                                                                     | Known informally as "the MDL Panel," the JPML oversees the process of transferring similar cases in different districts in order to coordinate or consolidate pretrial proceedings.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

<details>

<summary>Full list of possible courts</summary>

* No Court
* *state courts*:
  * Alabama state appellate court
  * Alabama state supreme court
  * Alabama state trial court
  * Alaska state appellate court
  * Alaska state supreme court
  * Alaska state trial court
  * American Samoa state appellate court
  * American Samoa state supreme court
  * American Samoa state trial court
  * Arizona state appellate court
  * Arizona state supreme court
  * Arizona state trial court
  * Arkansas state appellate court
  * Arkansas state supreme court
  * Arkansas state trial court
  * California state appellate court
  * California state supreme court
  * California state trial court
  * Colorado state appellate court
  * Colorado state supreme court
  * Colorado state trial court
  * Connecticut state appellate court
  * Connecticut state supreme court
  * Connecticut state trial court
  * Delaware state appellate court
  * Delaware state supreme court
  * Delaware state trial court
  * District of Columbia state appellate court
  * District of Columbia state supreme court
  * District of Columbia state trial court
  * Federated States of Micronesia state appellate court
  * Federated States of Micronesia state supreme court
  * Federated States of Micronesia state trial court
  * Florida state appellate court
  * Florida state supreme court
  * Florida state trial court
  * Georgia state appellate court
  * Georgia state supreme court
  * Georgia state trial court
  * Guam state appellate court
  * Guam state supreme court
  * Guam state trial court
  * Hawaii state appellate court
  * Hawaii state supreme court
  * Hawaii state trial court
  * Idaho state appellate court
  * Idaho state supreme court
  * Idaho state trial court
  * Illinois state appellate court
  * Illinois state supreme court
  * Illinois state trial court
  * Indiana state appellate court
  * Indiana state supreme court
  * Indiana state trial court
  * Iowa state appellate court
  * Iowa state supreme court
  * Iowa state trial court
  * Kansas state appellate court
  * Kansas state supreme court
  * Kansas state trial court
  * Kentucky state appellate court
  * Kentucky state supreme court
  * Kentucky state trial court
  * Louisiana state appellate court
  * Louisiana state supreme court
  * Louisiana state trial court
  * Maine state appellate court
  * Maine state supreme court
  * Maine state trial court
  * Marshall Islands state appellate court
  * Marshall Islands state supreme court
  * Marshall Islands state trial court
  * Maryland state appellate court
  * Maryland state supreme court
  * Maryland state trial court
  * Massachusetts state appellate court
  * Massachusetts state supreme court
  * Massachusetts state trial court
  * Michigan state appellate court
  * Michigan state supreme court
  * Michigan state trial court
  * Minnesota state appellate court
  * Minnesota state supreme court
  * Minnesota state trial court
  * Mississippi state appellate court
  * Mississippi state supreme court
  * Mississippi state trial court
  * Missouri state appellate court
  * Missouri state supreme court
  * Missouri state trial court
  * Montana state appellate court
  * Montana state supreme court
  * Montana state trial court
  * Nebraska state appellate court
  * Nebraska state supreme court
  * Nebraska state trial court
  * Nevada state appellate court
  * Nevada state supreme court
  * Nevada state trial court
  * New Hampshire state appellate court
  * New Hampshire state supreme court
  * New Hampshire state trial court
  * New Jersey state appellate court
  * New Jersey state supreme court
  * New Jersey state trial court
  * New Mexico state appellate court
  * New Mexico state supreme court
  * New Mexico state trial court
  * New York state appellate court
  * New York state supreme court
  * New York state trial court
  * North Carolina state appellate court
  * North Carolina state supreme court
  * North Carolina state trial court
  * North Dakota state appellate court
  * North Dakota state supreme court
  * North Dakota state trial court
  * Northern Mariana Islands state appellate court
  * Northern Mariana Islands state supreme court
  * Northern Mariana Islands state trial court
  * Ohio state appellate court
  * Ohio state supreme court
  * Ohio state trial court
  * Oklahoma state appellate court
  * Oklahoma state supreme court
  * Oklahoma state trial court
  * Oregon state appellate court
  * Oregon state supreme court
  * Oregon state trial court
  * Palau state appellate court
  * Palau state supreme court
  * Palau state trial court
  * Pennsylvania state appellate court
  * Pennsylvania state supreme court
  * Pennsylvania state trial court
  * Puerto Rico state appellate court
  * Puerto Rico state supreme court
  * Puerto Rico state trial court
  * Rhode Island state appellate court
  * Rhode Island state supreme court
  * Rhode Island state trial court
  * South Carolina state appellate court
  * South Carolina state supreme court
  * South Carolina state trial court
  * South Dakota state appellate court
  * South Dakota state supreme court
  * South Dakota state trial court
  * Tennessee state appellate court
  * Tennessee state supreme court
  * Tennessee state trial court
  * Texas state appellate court
  * Texas state supreme court
  * Texas state trial court
  * Utah state appellate court
  * Utah state supreme court
  * Utah state trial court
  * Vermont state appellate court
  * Vermont state supreme court
  * Vermont state trial court
  * Virgin Islands state appellate court
  * Virgin Islands state supreme court
  * Virgin Islands state trial court
  * Virginia state appellate court
  * Virginia state supreme court
  * Virginia state trial court
  * Washington state appellate court
  * Washington state supreme court
  * Washington state trial court
  * West Virginia state appellate court
  * West Virginia state supreme court
  * West Virginia state trial court
  * Wisconsin state appellate court
  * Wisconsin state supreme court
  * Wisconsin state trial court
  * Wyoming state appellate court
  * Wyoming state supreme court
  * Wyoming state trial court
* *U.S. district courts*:
  * Middle District of Alabama
  * Northern District of Alabama
  * Southern District of Alabama
  * District of Alaska
  * District of Arizona
  * Eastern District of Arkansas
  * Western District of Arkansas
  * Central District of California
  * Eastern District of California
  * Northern District of California
  * Southern District of California
  * District of Colorado
  * District of Connecticut
  * District of Delaware
  * District of Columbia
  * Middle District of Florida
  * Northern District of Florida
  * Southern District of Florida
  * Middle District of Georgia
  * Northern District of Georgia
  * Southern District of Georgia
  * District of Hawaii
  * District of Idaho
  * Central District of Illinois
  * Northern District of Illinois
  * Southern District of Illinois
  * Northern District of Indiana
  * Southern District of Indiana
  * Northern District of Iowa
  * Southern District of Iowa
  * District of Kansas
  * Eastern District of Kentucky
  * Western District of Kentucky
  * Eastern District of Louisiana
  * Middle District of Louisiana
  * Western District of Louisiana
  * District of Maine
  * District of Maryland
  * District of Massachusetts
  * Eastern District of Michigan
  * Western District of Michigan
  * District of Minnesota
  * Northern District of Mississippi
  * Southern District of Mississippi
  * Eastern District of Missouri
  * Western District of Missouri
  * District of Montana
  * District of Nebraska
  * District of Nevada
  * District of New Hampshire
  * District of New Jersey
  * District of New Mexico
  * Eastern District of New York
  * Northern District of New York
  * Southern District of New York
  * Western District of New York
  * Eastern District of North Carolina
  * Middle District of North Carolina
  * Western District of North Carolina
  * District of North Dakota
  * Northern District of Ohio
  * Southern District of Ohio
  * Eastern District of Oklahoma
  * Northern District of Oklahoma
  * Western District of Oklahoma
  * District of Oregon
  * Eastern District of Pennsylvania
  * Middle District of Pennsylvania
  * Western District of Pennsylvania
  * District of Puerto Rico
  * District of Rhode Island
  * District of South Carolina
  * District of South Dakota
  * Eastern District of Tennessee
  * Middle District of Tennessee
  * Western District of Tennessee
  * Eastern District of Texas
  * Northern District of Texas
  * Southern District of Texas
  * Western District of Texas
  * District of Utah
  * District of Vermont
  * Eastern District of Virginia
  * Western District of Virginia
  * Eastern District of Washington
  * Western District of Washington
  * Northern District of West Virginia
  * Southern District of West Virginia
  * Eastern District of Wisconsin
  * Western District of Wisconsin
  * District of Wyoming
  * District Court of Guam
  * District Court for the Northern Mariana Islands
  * District Court of the Virgin Islands
* *U.S. appellate courts*:
  * U. S. Court of Appeals for the First Circuit
  * U. S. Court of Appeals for the Second Circuit
  * U. S. Court of Appeals for the Third Circuit
  * U. S. Court of Appeals for the Fourth Circuit
  * U. S. Court of Appeals for the Fifth Circuit
  * U. S. Court of Appeals for the Sixth Circuit
  * U. S. Court of Appeals for the Seventh Circuit
  * U. S. Court of Appeals for the Eighth Circuit
  * U. S. Court of Appeals for the Ninth Circuit
  * U. S. Court of Appeals for the Tenth Circuit
  * U. S. Court of Appeals for the Eleventh Circuit
  * U. S. Court of Appeals for the District of Columbia Circuit
  * U. S. Court of Appeals for the Federal Circuit
* Supreme Court of the United States
* *specialty courts*:
  * Foreign Intelligence Surveillance Court
  * Foreign Intelligence Surveillance Court of Review
  * U. S. Court of International Trade
  * U.S. Court of Appeals for Veterans Claims
  * U.S. Judicial Panel on Multidistrict Litigation (JPML)

</details>

## court\_list

*(array\[string])*

All courts relevant to the case, including the starting court. If a case entry concerns litigation that happens in multiple courts (e.g. appeals, consolidations), `court_list` contains each court involved in the case lifecycle. The first court in `court_list` is typically the same as `court`.

See [#court](#court "mention") for list of possible courts.

## court\_level\_summaries

(array\[string])

The summarized court levels that apply to the case. The possible values are:

* Federal
* State
* No Court

## case\_types

(*array\[string]*)

The case types that apply to the case. Every case has at least one type, and some will have multiple.

For a full list of possible case types (with descriptions), see [here](https://clearinghouse.net/case-types).

## special\_collections

(*array\[string]*)

The special collections that a case belongs to. Special collections are pre-tagged groupings of cases that we think might be of particular interest. If the case does not belong to any special collections, `special_collections` is an empty array.

If a case also belongs to a sub-grouping within a special collection, the sub-category name is included separated by a pipe from the super collection, for example "Trump Administration 2.0: Challenges to the Government | Birthright Citizenship" is a sub-category titled "Birthright Citizenship" in the super-category "Trump Administration 2.0: Challenges to the Government."

For a full list of possible special collections (with descriptions), see [here](https://clearinghouse.net/collections).

## case\_ongoing

(*string*)

Whether the case is ongoing. Possible values:

| Value                     | Description                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| Yes                       | There are still things that will happen in the case.                                             |
| Unknown                   | We aren't sure if anything else will happen.                                                     |
| Perhaps, but long dormant | We think there might still be things to happen in the case, but nothing has happened for awhile. |
| No reason to think so     | We don't think the case is still ongoing, but we're not sure.                                    |
| No                        | The case is closed.                                                                              |

If this field is empty, then check the [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).


# Causes of Action

A cause of action is the statute or theory that permits you to bring a lawsuit. This is different from a claim. A claim is the theory of what makes the defendant’s conduct unlawful. The cause of action is not why something is unlawful, but rather why you can bring a lawsuit about it.

In some circumstances, the theory of what makes the defendant’s conduct unlawful (the claim) and the cause of action will be the same. For many statutory claims, the cause of action and the claim will be the same because the statute that was violated either has an explicit cause of action or has an inferred cause of action. For example, Title VII of the Civil Rights Act of 1964 includes both an explicit cause of action and substantive law not to discriminate.

But in many cases, the claim and the cause of action will be different, even with statutory claims. Then, the plaintiffs need another avenue to get into court. For example, the Clearinghouse has many cases involving constitutional claims that rely on one or more of the following causes of action: 42 U.S.C. § 1983, *Ex parte Young*, and *Bivens*. Which of these causes action applies depends on the type of government officials being sued and the relief sought by the plaintiffs:

| Relief Sought     | Defendant Type           | Cause(s) of Action                                 |
| ----------------- | ------------------------ | -------------------------------------------------- |
| damages           | state or local officials | 42 U.S.C. § 1983                                   |
| injunctive relief | state or local officials | <p>42 U.S.C. § 1983<br><em>Ex parte Young</em></p> |
| damages           | federal officials        | *Bivens*                                           |
| injunctive relief | federal officials        | *Ex parte Young*                                   |

## causes

(*array\[string]*)

The cause(s) of action for the case. If `causes` is an empty list, then check [#cause\_other](#cause_other "mention") for a cause of action not in the Clearinghouse's predefined list or check [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

Possible causes of action:

| Value                                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 42 U.S.C. § 1981                                                                                                      | This law prohibits race-based employment discrimination.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 42 U.S.C. § 1982                                                                                                      | This law prohibits race-based discrimination in the sale or rental of property.                                                                                                                                                                                                                                                                                                                                                                                                     |
| 42 U.S.C. § 1983                                                                                                      | This law allows people to bring a lawsuit against persons acting under color of state law for violating federal constitutional or statutory rights.                                                                                                                                                                                                                                                                                                                                 |
| 42 U.S.C. § 1985                                                                                                      | This law allows people to bring a lawsuit for three types of conspiracy: (1) preventing an officer from performing their duties, (2) obstructing justice by intimidating a party, witness, or juror, and (3) depriving a person's rights or privileges.                                                                                                                                                                                                                             |
| Administrative Procedure Act, 5 U.S.C. §§ 551 et seq.                                                                 | This law governs federal administrative agencies and how they propose/establish regulations. It has been called a "constitution" for administrative law.                                                                                                                                                                                                                                                                                                                            |
| Adoption Assistance and Child Welfare Act of 1980 (AACWA), 42 U.S.C. §§ 620 et seq.                                   | This law's purpose was to (1) establish a program of adoption assistance, (2) strengthen foster care assistance, and (3) improve the child welfare, social services, and aid to families with dependent children programs.                                                                                                                                                                                                                                                          |
| Adoption Assistance Program, 42 U.S.C. §§ 670 et seq.                                                                 | This law gives funding to states to create programs that facilitate the adoption of children who would otherwise remain in long-term foster care.                                                                                                                                                                                                                                                                                                                                   |
| Age Discrimination in Employment Act (ADEA), 29 U.S.C. §§ 621 et seq.                                                 | This law prohibits age-based employment discrimination against people age 40 and older.                                                                                                                                                                                                                                                                                                                                                                                             |
| Alien Tort Claims Act (ATCA), 28 U.S.C. §§ 1350                                                                       | This law allows aliens to bring tort claims alleging violations of international law in federal district court.                                                                                                                                                                                                                                                                                                                                                                     |
| All Writs Act, 28 U.S.C. § 1651                                                                                       | This law allows courts to issue writs (legal orders).                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Americans with Disabilities Act (ADA), 42 U.S.C. §§ 12111 et seq.                                                     | This law prohibits discrimination against people with disabilities in employment, government services, public transit, businesses open to the public, telecommunications, and other activities.                                                                                                                                                                                                                                                                                     |
| Child Abuse Prevention and Treatment Act, 42 U.S.C. §§ 5101 et seq.                                                   | This law provides federal funding for programs for prevention, identification, and treatment of child abuse and neglect. It also provides a minimum definition of "child abuse and neglect."                                                                                                                                                                                                                                                                                        |
| Civil Rights Act of 1957/1960, 52 U.S.C. § 10101 (previously 42 U.S.C. § 1971)                                        | The Civil Rights Act of 1957 was the first post-Reconstruction civil rights law. Among other things, it allowed federal prosecutors to obtain injunctions against interfering with the right to vote (particularly for Black Americans). The Civil Rights Act of 1960 was enacted largely to address the shortcomings of the 1957 law.                                                                                                                                              |
| Civil Rights of Institutionalized Persons Act (CRIPA), 42 U.S.C. § 1997 et seq.                                       | This law allows the Attorney General of the U.S. to review practices and conditions in state- and local-run prisons and jails.                                                                                                                                                                                                                                                                                                                                                      |
| Clean Water Act (CWA), 33 U.S.C. § 1319 et seq.                                                                       | This law regulates discharges of pollutants into U.S. waters and quality standards for surface waters.                                                                                                                                                                                                                                                                                                                                                                              |
| Clean Air Act, 42 U.S.C. §7401 et seq.                                                                                | This law regulates air pollution. For example, it requires the EPA to adopt national air quality standards that states then must meet.                                                                                                                                                                                                                                                                                                                                              |
| Community Reinvestment Act, 12 U.S.C. § 2901                                                                          | This law requires federal banking agencies to assess how well depository institutions (e.g. banks) are meeting the needs of their communities, including low- and moderate-income communities.                                                                                                                                                                                                                                                                                      |
| Criminal Conspiracy to Violate Federal Rights, 18 U.S.C. § 241                                                        | This law makes it a federal crime to agree with others to violate federal rights while acting in a state capacity.                                                                                                                                                                                                                                                                                                                                                                  |
| Criminal Violation of Federal Rights Under Color of Law, 18 U.S.C. § 242                                              | This law makes it a federal crime to violate federal rights while acting in a state capacity.                                                                                                                                                                                                                                                                                                                                                                                       |
| Declaratory Judgment Act, 28 U.S.C. § 2201                                                                            | This law allows courts to grant declaratory judgments as relief, but the law does not independently provide a basis for relief.                                                                                                                                                                                                                                                                                                                                                     |
| Developmental Disabilities Assistance and Bill of Rights Act, 42 U.S.C. § 15001 et seq.                               | This law establishes programs for helping individuals with development disabilities and their families.                                                                                                                                                                                                                                                                                                                                                                             |
| Employee Retirement Income Security Act (ERISA), 29 U.S.C. § 1001                                                     | This law sets standards for most private retirement and health plans to provide protection for individuals on those plans.                                                                                                                                                                                                                                                                                                                                                          |
| Endangered Species Act, 16 U.S.C. § 1531 et seq.                                                                      | This law establishes protections for fish, wildlife, and plants that are listed as threatened or endangered; it also manages those lists of threatened or endangered species.                                                                                                                                                                                                                                                                                                       |
| Equal Credit Opportunity Act (ECOA), 15 U.S.C. § 1691                                                                 | This law prohibits discrimination in activity under the Consumer Credit Protection Act and requires creditors to provide reasons for denying an applicant credit.                                                                                                                                                                                                                                                                                                                   |
| Equal Pay Act, 29 U.S.C. § 206(d)                                                                                     | This law requires that men and women in the same workplace be given equal pay for equal work.                                                                                                                                                                                                                                                                                                                                                                                       |
| Ex Parte Young (Federal) or Bivens                                                                                    | This combination enables damage suits brought against federal officials (see above).                                                                                                                                                                                                                                                                                                                                                                                                |
| Ex parte Young (federal or state officials)                                                                           | *Ex parte Young* enables injunctive suits brought against federal officials or state officials (see above).                                                                                                                                                                                                                                                                                                                                                                         |
| Fair Credit Reporting Act, 15 U.S.C. § 1681 ("FCRA")                                                                  | This law protects information collected by consumer reporting agencies.                                                                                                                                                                                                                                                                                                                                                                                                             |
| Fair Housing Act/Fair Housing Amendments Act (FHAA), 42 U.S.C. §§ 3601 et seq.                                        | This law prohibits discrimination in housing, covering rentals, sales, mortgages, advertising, and other housing-related activities.                                                                                                                                                                                                                                                                                                                                                |
| Fair Labor Standards Act (FLSA), 29 U.S.C. §§ 201-219                                                                 | This law establishes minimum wage, overtime pay, recordkeeping, and youth employment standards.                                                                                                                                                                                                                                                                                                                                                                                     |
| False Claims Act, 31 U.S.C. § 3729                                                                                    | This law creates a penalty for anyone who knowingly submits, or causes to submit, false claims to the government.                                                                                                                                                                                                                                                                                                                                                                   |
| Federal Campaign Finance law, 2 U.S.C. §§ 431 et seq.                                                                 | This law puts limits on campaign contributions to candidates for president and Congress.                                                                                                                                                                                                                                                                                                                                                                                            |
| Federal Tort Claims Act (FTCA), 28 U.S.C. § 2674                                                                      | This law authorizes damage suits against the federal government for torts of its employees.                                                                                                                                                                                                                                                                                                                                                                                         |
| FISA Title III Warrant (Physical Search), 50 U.S.C. §§ 1821-1829                                                      | The Foreign Intelligence Surveillance Act (FISA) provides judicial and congressional oversight of government agencies engaging in foreign intelligence surveillance activities. Title III allows agencies to seek a warrant for physical searches to collect foreign intelligence.                                                                                                                                                                                                  |
| FISA Title IV order (pen register/trap-and-trace), 50 U.S.C. §§ 1841-1846                                             | The Foreign Intelligence Surveillance Act (FISA) provides judicial and congressional oversight of government agencies engaging in foreign intelligence surveillance activities. Title IV allows agencies to seek an order authorizing the installation of pen register and trap-and-trace devices to collect foreign intelligence.                                                                                                                                                  |
| FISA Title I Warrant (Electronic Surveillance), 50 U.S.C. §§ 1801-1812                                                | The Foreign Intelligence Surveillance Act (FISA) provides judicial and congressional oversight of government agencies engaging in foreign intelligence surveillance activities. Title I allows agencies to seek a warrant for electronic surveillance to collect foreign intelligence.                                                                                                                                                                                              |
| FISA Title VII targeting order (Sections 702, 703, 704), 50 U.S.C. 1881a, 1881b, 1881c                                | The Foreign Intelligence Surveillance Act (FISA) provides judicial and congressional oversight of government agencies engaging in foreign intelligence surveillance activities. Section 702 permits foreign intelligence surveillance targeting the communications of non-U.S. persons located abroad without needing to establish probable cause. There is a [special collection](https://clearinghouse.net/search/case/?special_collection=5663) related to this cause of action. |
| FISA Title V order (PATRIOT Act § 215, business records or other tangible things), 50 U.S.C. §§ 1861-1862             | The Foreign Intelligence Surveillance Act (FISA) provides judicial and congressional oversight of government agencies engaging in foreign intelligence surveillance activities. Title V allows agencies to seek an order compelling certain businesses to release records in connection with a foreign intelligence investigation by the FBI. Section 215 of the PATRIOT Act (expired in 2020), expanded business records to include "any tangible thing."                          |
| Freedom of Information Act (FOIA), 5 U.S.C. § 552                                                                     | This law requires disclosure of documents controlled by federal or state governments (or other public authorities) upon request.                                                                                                                                                                                                                                                                                                                                                    |
| Habeas Corpus, 28 U.S.C. §§ 2241-2253; 2254; 2255                                                                     | This law allows an individual files a civil suit challenging their criminal conviction. Habeas is generally considered an individual's last resort attempt to overturn their sentence.                                                                                                                                                                                                                                                                                              |
| Help America Vote Act (HAVA), 52 U.S.C. § 20901 et seq (previously 42 U.S.C. § 15301 et seq)                          | This law addressed improvements to voting systems and voter access that were identified following the 2000 election.                                                                                                                                                                                                                                                                                                                                                                |
| Illegal Immigration Reform and Immigrant Responsibility Act of 1996 (IIRIRA)                                          | This law provides increased penalties for undocumented immigrants who commit crimes while in the U.S., allows for the deportation for undocumented immigrants who commit a misdemeanor or felony, and provides additional restrictions for asylum applications.                                                                                                                                                                                                                     |
| Immigration and Nationality Act (INA), 8 U.S.C. §§ 1101 et seq.                                                       | This law covers many aspects of immigration law, such as naturalization and refugee assistance.                                                                                                                                                                                                                                                                                                                                                                                     |
| Immigration Reform and Control Act of 1986 (IRCA)                                                                     | This law prohibits knowingly employing illegal immigrants.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Indv. w/ Disab. Educ. Act (IDEA), Educ. of All Handcpd. Children Act , 20 U.S.C. § 1400                               | These laws ensure that children with disabilities have access to free appropriate education, including special education and related services.                                                                                                                                                                                                                                                                                                                                      |
| Juvenile Justice Act, 42 U.S.C. § 5672                                                                                | A section of the Juvenile Justice and Delinquency Prevention Act, which supports local and state efforts to prevent delinquency and improve juvenile justice systems.                                                                                                                                                                                                                                                                                                               |
| Mandamus, 28 U.S.C. § 1361                                                                                            | This law authorizes federal courts to compel government employees to do their duty.                                                                                                                                                                                                                                                                                                                                                                                                 |
| Medicaid, 42 U.S.C §1396 (Title XIX of the Social Security Act)                                                       | Medicaid provides health coverage to eligible low-income adults, children, pregnant women, elderly adults and people with disabilities.                                                                                                                                                                                                                                                                                                                                             |
| Medicare, 42 U.S.C. 1395-1395lll (Title XVIII of the Social Security Act)                                             | Medicare provides health coverage to individuals 65 and older, certain younger individuals with disabilities, and those with End-Stage Renal Disease.                                                                                                                                                                                                                                                                                                                               |
| Migrant and Seasonal Agricultural Workers Protection Act, 29 U.S.C. §§ 1801-1871                                      | This law protects migrant and seasonal agricultural workers by establishing employment standards related to wages, housing, transportation, disclosures and recordkeeping.                                                                                                                                                                                                                                                                                                          |
| National Environmental Protection Act, 42 U.S.C. §§ 4321–4370f                                                        | This law requires federal agencies to assess the environmental effects of their proposed actions prior to making decisions.                                                                                                                                                                                                                                                                                                                                                         |
| National Labor Relations Act                                                                                          | This law provides private-sector employees the fundamental right to seek better working conditions and designation of representation without fear of retaliation.                                                                                                                                                                                                                                                                                                                   |
| National Voter Registration Act ("Motor Voter law"), 52 U.S.C. § 20501 (previously 42 U.S.C. § 1973gg)                | This law requires state governments to offer simplified voter registration processes for any eligible person who applies for or renews a driver's license or applies for public assistance. The law also allows the DOJ to bring civil actions in federal court to enforce its requirements.                                                                                                                                                                                        |
| Nursing Care Reform Act of 1987/ Omnibus Reconciliation Act                                                           | The Nursing Home Reform Act was passed as part of the Omnibus Reconciliation Act of 1987, which establishes performance standards for nursing homes.                                                                                                                                                                                                                                                                                                                                |
| Protection and Advocacy for Individuals with Mental Illness (PAIMI) Act, 42 U.S.C. § 10801                            | This law protects the rights of individuals with mental illnesses.                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Protection and Advocacy of Individual Rights (PAIR), 29 U.S.C. § 794e                                                 | This law supports the protection and advocacy system in each state to protect the legal and human rights of individuals with disabilities.                                                                                                                                                                                                                                                                                                                                          |
| Racketeer Influenced and Corrupt Organizations Act (RICO), 18 U.S.C. §§ 1961 et seq.                                  | This law authorizes civil lawsuits for acts performed as part of an ongoing criminal organization.                                                                                                                                                                                                                                                                                                                                                                                  |
| Religious Freedom Rest. Act/Religious Land Use and Inst. Persons Act (RFRA/RLUIPA)                                    | RFRA provided a "strict scrutiny" standard for evaluating generally applicable and neutral laws that pose a burden on someone's religious practice. RLUIPA applied the same principle to state and local governments.                                                                                                                                                                                                                                                               |
| Resource Conservation and Recovery Act (RCRA), 42 U.S.C. § 6928 et seq.                                               | This law the proper management of hazardous and non-hazardous solid waste.                                                                                                                                                                                                                                                                                                                                                                                                          |
| Section 504 (Rehabilitation Act), 29 U.S.C. § 701                                                                     | This law guarantees certain rights to people with disabilities.                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Social Security (Title XX), 42 U.S.C. §§ 1397 et seq.                                                                 | Also known as the Social Services Block Grant, Title XX provides federal funding to states and territories to support social services for vulnerable children, adults, and families.                                                                                                                                                                                                                                                                                                |
| State Anti-Discrimination Law                                                                                         | Any state law (as opposed to a federal law) that prohibits discrimination.                                                                                                                                                                                                                                                                                                                                                                                                          |
| State law                                                                                                             | Any state law (as opposed to a federal law).                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Title IV, Civil Rights Act of 1964, 42 U.S.C. § 2000c et seq.                                                         | This law prohibits segregation and discrimination in public school and university systems. It authorizes the U.S. Attorney General to bring enforcement actions.                                                                                                                                                                                                                                                                                                                    |
| Title IX of the Education Amendments of 1972, 20 U.S.C. §§ 1681 et seq.                                               | This law prohibits sex (including pregnancy, sexual orientation, and gender identity) discrimination in any education program or activity receiving federal financial assistance.                                                                                                                                                                                                                                                                                                   |
| Title VI, Civil Rights Act of 1964, 42 U.S.C. § 2000d et seq.                                                         | This law prohibits discrimination by recipients of federal financial assistance. It authorizes federal agencies to conduct investigations and (in some cases) private individuals to bring lawsuits.                                                                                                                                                                                                                                                                                |
| Title VII (including PDA), 42 U.S.C. § 2000e                                                                          | This law prohibits discrimination in employment on the basis of "race, color, religion, sex, or national origin." It authorizes lawsuits brought by the Equal Employment Opportunity Commission (EEOC), the DOJ, and private individuals.                                                                                                                                                                                                                                           |
| Trafficking Victims Protection Act (TVPA), 18 U.S.C. § 1589                                                           | This law prohibits human trafficking and provides for protection of human trafficking victims.                                                                                                                                                                                                                                                                                                                                                                                      |
| Uniformed and Overseas Citizens Absentia Voting Act, 52 U.S.C. § 20301 (previously 42 U.S.C. § 1973ff et seq.)        | This law requires states and territories to allow absentee voting for members of the U.S. military, their families, and U.S. citizens living abroad.                                                                                                                                                                                                                                                                                                                                |
| Uniformed Services Employment and Reemployment Rights Act (USERRA), 38 U.S.C. § 4301                                  | This law prohibits employment discrimination against members of the U.S. military and veterans on the basis of their service.                                                                                                                                                                                                                                                                                                                                                       |
| Violent Crime and Law Enforcement Act, 34 U.S.C. § 12601 (previously 42 U.S.C. § 14141)                               | This law addresses crime and law enforcement. Among many other things, it defines and classifies various crimes.                                                                                                                                                                                                                                                                                                                                                                    |
| Voting Accessibility law, 52 U.S.C. § 20102 (previously 42 U.S.C. §§ 1973ee et seq.)                                  | This law requires accessible polling places in federal elections for elderly individuals and people with disabilities (or alternative means of voting).                                                                                                                                                                                                                                                                                                                             |
| Voting Rights Act, section 203 (language minority provision), 52 U.S.C. § 10503 (previously 42 U.S.C. § 1973aa-1a)    | This law requires that all election information that is available in English also be available in the language of specific minority communities.                                                                                                                                                                                                                                                                                                                                    |
| Voting Rights Act, section 208 (assistance for disabled persons), 52 U.S.C. § 10508 (previously 42 U.S.C. § 1973aa-6) | This law provides for voters who need assistance to vote by reason of blindness, disability, or inability to read or write.                                                                                                                                                                                                                                                                                                                                                         |
| Voting Rights Act, section 2, 52 U.S.C. § 10301 (previously 42 U.S.C. § 1973)                                         | This law prohibits voting practices and procedures that discriminate on the basis of race, color or membership in a language minority group.                                                                                                                                                                                                                                                                                                                                        |
| Voting Rights Act, section 5, 52 U.S.C. § 10304 (previously 42 U.S.C. § 1973c)                                        | This law provides a preclearance requirement whereby changes in voting practices and procedures in certain locations must be found to have no discriminatory purpose or effect before those changes can be put into place.                                                                                                                                                                                                                                                          |
| Voting Rights Act, unspecified, 52 U.S.C. § 10301 et seq (previously 42 U.S.C § 1973 et seq.)                         | The Voting Rights Act protects the right to vote for minority populations (and was originally enacted to overcome barriers for Black Americans to vote). This option is a catch-all option for provisions that don't have their own option (above).                                                                                                                                                                                                                                 |

## cause\_other

(*string*)

The case's cause(s) of action that are not in the Clearinghouse's predefined list.


# Outcome

## relief\_natures

(*array\[string]*)

What kind of relief was awarded in the case. (If a type of relief was sought but denied, it is not included here.)

| Value                                          | Description                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Attorneys fees                                 | Money awarded to compensate the attorneys on the other side.                                                                                                                                                                                                                                                                                     |
| Declaratory Judgment                           | A judgment that states the court's authoritative opinion. Unlike an injunction (below), a declaratory judgment does not require a party to take action or pay money.                                                                                                                                                                             |
| Injunction/Injunctive-like Settlement          | An injunction is a court order that requires a party to stop or start doing something. An injunctive-like settlement is for when the case settles before an injunction can be issued, but the terms of the settlement require a party to stop or start doing something (likely what the plaintiffs sought an injunction for in the first place). |
| Criminal Conviction                            | In a criminal case, a final judgment on a verdict of guilty, a plea of guilty, or a plea of nolo contendere (where a criminal defendant does not accept or deny responsibility for the charges but agrees to accept punishment).                                                                                                                 |
| Damages                                        | Money awarded in the case. This can include compensatory damages (to compensate the victim) and punitive damages (to punish the offending party).                                                                                                                                                                                                |
| Document/information produced                  | Where the defendant(s) provided the requested documents or information. This is common with Freedom of Information Act (FOIA) cases.                                                                                                                                                                                                             |
| Habeas relief                                  | An individual successfully challenged their criminal conviction and imprisonment in a civil suit. Habeas is generally considered an individual's last resort attempt to overturn their sentence.                                                                                                                                                 |
| Preliminary injunction/Temp. restraining order | An order issued before the final judgment of the case that requires a party to stop or start doing something.                                                                                                                                                                                                                                    |
| Warrant/Order allowing surveillance            | In cases before the Foreign Intelligence Surveillance Court (FISA Court), a warrant or order for electronic surveillance of someone suspected of spying with or for a foreign government.                                                                                                                                                        |
| None                                           | No relief was awarded in the case.                                                                                                                                                                                                                                                                                                               |
| None yet                                       | There could still be relief awarded in the case, but the case is ongoing.                                                                                                                                                                                                                                                                        |
| Unknown                                        | We do not know what relief was awarded in the case.                                                                                                                                                                                                                                                                                              |

If this field is an empty array, then the case's metadata is likely not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

## relief\_sought

The types of legal relief sought by the plaintiff(s) in the case.

**Possible values:**

* Attorneys fees
* Criminal conviction
* Damages
* Declaratory judgment
* Document/Information
* Habeas
* Injunction
* Receivership
* Stay of government action
* Stay of injunction
* Stay of proceedings
* Warrant/Order allowing surveillance

## relief\_nature\_other

(*string*)

Types of relief awarded that are not in the Clearinghouse's predefined list. It is rare for a case to have something for this field; in most cases, `relief_nature_other` will be an empty string.

## relief\_sources

(*array\[string]*)

The source of the relief awarded in the case. The values `"None"`, `"None yet"`, and `"Unknown"` correspond to the same options under [#relief\_natures](#relief_natures "mention").

| Value      | Description                                                               |
| ---------- | ------------------------------------------------------------------------- |
| Litigation | The relief was ordered through a court order.                             |
| Settlement | The relief was a result of a settlement agreement.                        |
| None       | No relief was awarded in the case.                                        |
| None yet   | There could still be relief awarded in the case, but the case is ongoing. |
| Unknown    | We do not know what relief was awarded in the case.                       |

If this field is an empty array, then the case's metadata is likely not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

## settlement\_agreement

(*array\[string]*)

The form of the settlement agreement, if there is one in the case.

| Value                                       | Description                                                                                                                                                                                                    |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Conditional Dismissal                       | When the plaintiff agrees to dismiss the case if and only if the defendant complies with some settlement terms. If the defendant fails to live up to those terms, the result is the reinstitution of the case. |
| Confession of Judgment                      | When the defendant agrees to liability. This is very unusual.                                                                                                                                                  |
| Court Approved Settlement or Consent Decree | If the parties agree to a settlement, and the court issues an order approving it. This is very common.                                                                                                         |
| Private Settlement Agreement                | If the parties agree to a settlement that is *not* approved by the court. The settlement terms are often private.                                                                                              |
| Voluntary Dismissal                         | When the plaintiff movees to dismiss the case, and the court grants the motion. This is often done by agreement when the parties settle for monetary damages but no injunction.                                |

If there is no settlement agreement in the case, then this field will be an empty array.

## prevailing\_party

(*string*)

Which party "won" the case. This doesn't necessarily have to be by a formal judgment; we also look at what relief has been awarded, whether through court orders or settlements, to determine which party prevailed.

| Value         | Description                                                  |
| ------------- | ------------------------------------------------------------ |
| Plaintiff     | The plaintiff(s) obtained any sort of relief, even if minor. |
| Defendant     | The defendant(s) prevailed.                                  |
| Mixed         | Both sides received some of what they were hoping for.       |
| None Yet/None | Neither side prevailed or there is no outcome yet.           |
| Unknown       | We don't know which side prevailed.                          |

If there has been a district court judgment but the case is pending appeal, `prevailing_party` reflects who won in district court.

If this field is an empty array, then the case's metadata is likely not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).

## defendant\_payment

(*string*)

How much the defendants paid as a result of the lawsuit. This is the combined amount for all damages, attorneys' fees, and any other costs. For cases where many payments happen over the course of some period of time (especially attorneys' fees), this value may not include all of the payments.

The format of this string varies, but here are some examples of how this string might be formatted:

* 5000
* 5000.00
* 5,000
* 5,000.00
* $5,000
* $5,000.00

In addition, sometimes this string contains text when we do not have an exact number. For example:

* redacted from court transcript
* roughly $1,000,000
* up to $1 billion

If this string is empty, there are a few possible reasons: we do not know how much the defendants paid, the defendants did not pay anything, or the case is still going. Also the case's metadata may not be complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).


# Issues

Issues are descriptions of things that are relevant to the litigation at hand. Importantly, they must be part of why the litigation arose. Thus, for example, just because someone speaks Vietnamese does not mean that the `"Vietnamese"` issue is coded. Instead, the case must exist in part because the person speaks Vietnamese. Another important note is that issues do not need to be true for them to be coded as such – issues are based on the allegations in the case, not what the court ends up finding to be factually true.

## issues

(*array\[string]*)

An array of issues. Issues are strings that are categorized into buckets based on their relation to others. Each of the following subheaders (for example, "Reproductive rights") is one such bucket, and that is reflected in the strings themselves.

For example, `"Reproductive rights: Admitting privileges"` corresponds to the issue "Admitting privileges" found within the "Reproductive rights" bucket.

### Reproductive rights

| Value                                                                    | Description |
| ------------------------------------------------------------------------ | ----------- |
| Admitting privileges                                                     |             |
| Birth control restrictions                                               |             |
| Complete abortion ban                                                    |             |
| Criminalization                                                          |             |
| Disposal procedures                                                      |             |
| Fetus Identity                                                           |             |
| Licensing restriction                                                    |             |
| Mandatory delay                                                          |             |
| Medication abortion                                                      |             |
| Method-based abortion procedures                                         |             |
| Parental notification                                                    |             |
| Physician-only abortion laws                                             |             |
| Spousal notification                                                     |             |
| Telemedicine                                                             |             |
| Time-based abortion prohibition                                          |             |
| Facility requirements                                                    |             |
| Cardiac activity legislation                                             |             |
| Patient disclosure requirement                                           |             |
| Undue Burden                                                             |             |
| Reproductive health care (including birth control, abortion, and others) |             |

### Constitutional Clause

| Value                                 | Description                                                                                                                                                                                                                                                          |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Commerce Power                        | If there is a question of whether or not the federal government could have taken this action under its Commerce Clause power, i.e. whether the law or action concerns "interstate commerce."                                                                         |
| Cruel and Unusual Punishment          | If someone alleges an Eighth Amendment violation.                                                                                                                                                                                                                    |
| Due Process                           | A clause within the Fifth and Fourteenth Amendments – includes procedural and substantive prongs. If this is selected, one of the following two should also be included.                                                                                             |
| Due Process: Procedural Due Process   | <p>If someone alleges that they have been unlawfully denied the right processes by which they can make their case. This might include things like needing a hearing or notice.<br><br>If this issue is included, then "Due Process" should also be included.</p>     |
| Due Process: Substantive Due Process  | <p>If someone alleges that the thing which they have been deprived is itself unlawful. This might include things like the right for LGBTQ+ people to marry or a right to abortion.<br><br>If this issue is included, then "Due Process" should also be included.</p> |
| Emoluments Clauses                    |                                                                                                                                                                                                                                                                      |
| Enumerations Clause                   |                                                                                                                                                                                                                                                                      |
| Equal Protection                      | If someone alleges that they have been subject to unequal treatment, either because the law on its face singles them (or people like them) out or because the law has an effect that affects only them (or people like them).                                        |
| Establishment Clause                  | If there is an allegation that the government is attempting to impose a set of religious beliefs on someone.                                                                                                                                                         |
| Excessive bail/fines                  | If someone claims that the amount they had to pay in fines or in fees to get out of jail were too high.                                                                                                                                                              |
| Ex Post Facto                         | If a law allegedly retroactively applied to criminalize someone's past conduct from when there was no law on the books.                                                                                                                                              |
| Federalism (including 10th Amendment) | If there is a conflict between state and federal laws or functions and where the federal government's actions might be intruding upon a traditionally state area.                                                                                                    |
| Fifteenth Amendment                   |                                                                                                                                                                                                                                                                      |
| Freedom of speech/association         | If the government unlawfully prevents someone from expressing themselves or associating with others. This frequently comes up in protest cases.                                                                                                                      |
| Free Exercise Clause                  | If the government unlawfully restricts the ability for people to engage in their own religious practices or exercise their faith.                                                                                                                                    |
| Full faith and credit                 | If there is a dispute that one court is not giving the full weight of another court's judgment (or another state's law) and instead is trying to come up with its own determination.                                                                                 |
| Petitions clause                      |                                                                                                                                                                                                                                                                      |
| Right to travel                       | If the government is unlawfully restricting someone's ability to move or travel.                                                                                                                                                                                     |
| Self-incrimination                    | If someone is maintaining their silence because they do not want to implicate themselves in a criminal investigation or trial but where the government is attempting to coax statements out of them.                                                                 |
| Slavery/Involuntary servitude         | If someone is alleging that they are being forced to work against their will or being forced to work for little or no compensation.                                                                                                                                  |
| Supremacy Clause                      | If there are conflicting state and federal laws and where there is a dispute as to whether the federal law should nullify or override the state law.                                                                                                                 |
| Suspension Clause                     |                                                                                                                                                                                                                                                                      |
| Takings                               | If someone's property is taken unlawfully or if it is taken without just compensation.                                                                                                                                                                               |
| Unreasonable search and seizure       | If someone's person is unlawfully searched or seized (arrested), or if their property is similarly searched or seized (e.g., forfeiture).                                                                                                                            |

### Special Case Type

| Value                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Appellate Court is initial court | <p>If the case begins instead in an appellate court. Typically cases that are litigated in court begin in a trial court. Common examples of appellate courts that cases might start in include a U.S. Court of Appeals, a state supreme court, or a state appellate court.</p><p>For more general information about courts, see <a data-mention href="/pages/ASScJpvNmFfIHS61F7Gc#court">/pages/ASScJpvNmFfIHS61F7Gc#court</a>.</p>                                                                    |
| Criminal                         | If a case is a criminal prosecution. Most cases in the Clearinghouse are civil cases that ask for someone to change their behavior or pay an amount of money. By contrast, criminal cases are where the consequence of a finding of liability (in criminal cases, guilt) is usually a prison sentence. A good indication that a case is criminal is if the docket number has the letters "cr" instead of "cv" between the numbers (see [Docket](/api-reference-v2p1/objects/docket#docket_case_type)). |
| Habeas                           | If an individual files a civil suit challenging their criminal conviction. As noted above, criminal cases generally are denoted differently. Habeas is generally considered an individual's last resort attempt to overturn their sentence.                                                                                                                                                                                                                                                            |
| Multi-District Litigation (MDL)  | <p>An MDL consists of litigation that occurs in multiple federal district courts. Unlike a "normal" case that stays in one court, an MDL combines or consolidates cases from different courts.</p><p>For example, a normal case might occur in the Northern District of California. An MDL might bring together cases from that court, the Southern District of Florida, and the Western District of New York together in one proceeding.</p>                                                          |
| Non-court arbitration/mediation  | Arbitration and mediation are alternate means of resolving disputes. Litigation is an adversarial proceeding between parties that's overseen by a judge. Arbitration and mediation by contrast have greater involvement from the non-party (the arbitrator or mediator) that attempts to reach a more peaceful resolution.                                                                                                                                                                             |
| Out-of-court                     | If a proceeding occurs completely outside of court. Examples include U.S. Department of Justice (DOJ) investigations and EEOC proceedings.                                                                                                                                                                                                                                                                                                                                                             |
| Tribal Court                     | If the proceeding occurs not in a federal or state court and seeks to resolve matters concerning indigenous tribes.                                                                                                                                                                                                                                                                                                                                                                                    |
| Warrant or subpoena application  | If someone goes to the court and asks for court approval to perform an action. Examples would include seeking a warrant to search someone's home or arrest a person. Additionally, parties might go to the court to obtain a subpoena that would force another person to appear in court or to provide testimony.                                                                                                                                                                                      |
| Three-Judge Court                | If federal district court litigation is overseen by a three-judge panel rather than by a single judge. This may arise in cases about prison overcrowding or older cases about voting rights challenges. These cases are increasingly uncommon.                                                                                                                                                                                                                                                         |

### General

| Value                                                          | Description                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Abortion                                                       | <p>If the case concerns an issue relating to abortion.</p><p>This will often be selected if a value in the "Reproductive Rights" category is also selected, but that is not always true. For example, if the case is about access to non-abortion birth control, then this value should not be selected despite a value in the "Reproductive Rights" section being marked.</p> |
| Access to lawyers or judicial system                           | If the case concerns someone claiming that they cannot reach or afford a lawyer or are prevented from filing their case with the court. This might often overlap with cases about people who are imprisoned and perhaps the Prison Litigation Reform Act (PLRA).                                                                                                               |
| Access to public accommodations - governmental                 | This is about a person's ability to enter and do their business in facilities and buildings that are publicly owned (e.g. post offices, public schools, libraries, or city halls).                                                                                                                                                                                             |
| Access to public accommodations - privately owned              | In contrast to governmental public accommodations (above), privately owned public accommodations are things like restaurants, dry cleaners, or movie theaters.                                                                                                                                                                                                                 |
| Administrative segregation                                     | If people in prison are kept in more isolated quarters, often for disciplinary reasons. This term (sometimes called "AdSeg") is often interchangeable with "solitary confinement" (below).                                                                                                                                                                                     |
| Adoption                                                       | If the case is about the ability of someone to adopt. This often coincides with discrimination on the basis of that person's sexual orientation or race.                                                                                                                                                                                                                       |
| Aggressive behavior                                            | If a plaintiff in a case alleges that they have been subjected to officials who act belligerently, perhaps to induce a reaction from that person. It might come up in cases alleging excessive force.                                                                                                                                                                          |
| Assault/abuse by residents/inmates/students                    | If someone alleges that they have been harmed by their peers (e.g. by other students at a school, by other incarcerated people in a prison).                                                                                                                                                                                                                                   |
| Assault/abuse by staff                                         | If someone alleges that they have been harmed by people who are supposed to supervise or take care of them.                                                                                                                                                                                                                                                                    |
| ATM Machines                                                   | If the case is about someone's ability to access an ATM.                                                                                                                                                                                                                                                                                                                       |
| Barrier Removal                                                | If the case is about a physical barrier that someone has constructed. For example, this might come up in cases about protests where police officers might have erected gates or fences.                                                                                                                                                                                        |
| Bathing and hygiene                                            | If the case is about someone's ability to live in clean spaces. Often this will come up in prison conditions cases alleging unhygienic cells or an inability to shower regularly.                                                                                                                                                                                              |
| Bathrooms                                                      | If the case concerns someone's ability to access functional bathrooms.                                                                                                                                                                                                                                                                                                         |
| Buildings                                                      | If the case is about something to do with a building (e.g., access to a building, state of maintenance of a building, etc.).                                                                                                                                                                                                                                                   |
| Classification / placement                                     | If the case is about how people are sorted into different places. Often this will be in the context of security-level for incarcerated persons or in a setting like a mental health care facility where someone alleges they are misplaced into the facility or denied access to a facility.                                                                                   |
| Commitment procedure                                           |                                                                                                                                                                                                                                                                                                                                                                                |
| Communication skills                                           | If the case is about someone's ability to speak or convey a message to someone else. For example, this might come up in language discrimination cases.                                                                                                                                                                                                                         |
| Concentrated Animal Feeding Operations (CAFOs)                 | If the case is about cruel treatment of animals in industrial-sized farms (termed "CAFOs").                                                                                                                                                                                                                                                                                    |
| Conditions of confinement                                      | If the case is broadly about conditions in a prison or jail. This can include things like hygiene, abuse by staff or peers, or solitary confinement.                                                                                                                                                                                                                           |
| Confidentiality                                                |                                                                                                                                                                                                                                                                                                                                                                                |
| Confinement/isolation                                          | If officials place incarcerated or detained people in isolated settings.                                                                                                                                                                                                                                                                                                       |
| Conflict of interest                                           | If a party alleges that someone should not have been involved in the case or situation because of a professional/personal relationship with someone else.                                                                                                                                                                                                                      |
| Contraception                                                  | If the case is about access to birth control (e.g., IUDs, Plan B, condoms, etc.).                                                                                                                                                                                                                                                                                              |
| Counseling                                                     | If the case is about improper denial of access to mental health treatment in the form of a counselor or therapist.                                                                                                                                                                                                                                                             |
| Courts                                                         | If the case is about access to or quality of the courts in some way. This is more than just a case that occurs in a federal or state court.                                                                                                                                                                                                                                    |
| Currency                                                       | If the case pertains to someone's ability to gain access to money in any format. Often will come up in prison conditions cases.                                                                                                                                                                                                                                                |
| Deinstitutionalization/decarceration                           | If the plaintiff seeks to be released from prison, jail, or a mental health treatment facility.                                                                                                                                                                                                                                                                                |
| Discharge & termination plans                                  | If the case concerns how, or under what terms, a person will be allowed to leave a facility (e.g., mental health treatment).                                                                                                                                                                                                                                                   |
| Discharge without permits                                      | If the case concerns environmental pollution and discharging pollutants without the requisite legal entitlements. This typically relates to allegations of violations of the Clean Water Act.                                                                                                                                                                                  |
| Disciplinary procedures                                        | If officials are alleged to wrongfully determine, or have wrongful processes to determine, whether someone should be subject to discipline.                                                                                                                                                                                                                                    |
| Disciplinary segregation                                       | If individuals are isolated away from the general population (usually in prison settings) as a means of punishing someone for infractions.                                                                                                                                                                                                                                     |
| Disparate Impact                                               | If the law is facially neutral (i.e., does not single out people on the basis of a protected status) but has harms that disproportionately affect certain communities.                                                                                                                                                                                                         |
| Disparate Treatment                                            | If the law singles out people from certain protected groups (e.g., race, sexual orientation, religion, etc.).                                                                                                                                                                                                                                                                  |
| Drivers Licenses                                               | If someone alleges difficulty in obtaining a drivers license, perhaps after incarceration or because of age or gender status.                                                                                                                                                                                                                                                  |
| Education                                                      | If someone alleges unavailable or inadequate education.                                                                                                                                                                                                                                                                                                                        |
| Effective Communication (ADA)                                  | If someone with a disability alleges that the lack of accommodations means that they lack the ability to receive information. Examples of effective communication might include a sign language interpreter or speech-to-text technology.                                                                                                                                      |
| Emergency shelter                                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Environmental Impact Statements                                | If the litigation is about official government documents that detail how a proposed project will affect the environment. Environmental Impact Statements (EISs) are a requirement in the National Environmental Policy Act (NEPA).                                                                                                                                             |
| Excessive force                                                | If an official allegedly caused physical harm that was disproportionate to what was needed in the moment. Often this will occur in the prison or police contexts.                                                                                                                                                                                                              |
| Extradition                                                    | If an individual is sought for criminal prosecution in another jurisdiction, often in an international context.                                                                                                                                                                                                                                                                |
| Failure to discipline                                          | If a lawsuit alleges that a employer failed to keep employees accountable via punishment or discipline when they commit unlawful acts. Often this arises in prison and police contexts.                                                                                                                                                                                        |
| Failure to supervise                                           | If a lawsuit alleges that an employer did not oversee the actions of its employees, which allowed the latter group to commit unlawful acts. Often this arises in the prison and police contexts.                                                                                                                                                                               |
| Failure to train                                               | If a lawsuit alleges that an employer did not instruct its employees on how to approach situations, which resulted in the latter group committing unlawful acts. Often this arises in the prison and police contexts.                                                                                                                                                          |
| False arrest                                                   | If someone alleges that they were arrested without probable cause, perhaps as an intimidation tactic or because the police misapplied the law.                                                                                                                                                                                                                                 |
| Family abuse and neglect                                       |                                                                                                                                                                                                                                                                                                                                                                                |
| Family reunification                                           | If the case is about bringing family members (commonly children and parents) back together after they have been separated. Often this comes up in immigration contexts.                                                                                                                                                                                                        |
| Fines/Fees/Bail/Bond                                           | If the monetary penalty associated with being arrested (or the cost of leaving jail) is allegedly too high or burdensome.                                                                                                                                                                                                                                                      |
| Fire safety                                                    | If circumstances make a fire more likely or more dangerous because of building conditions, etc. that might not be in compliance with city codes.                                                                                                                                                                                                                               |
| Food service / nutrition / hydration                           | If the food or water being offered is inadequate, either nutritionally or quantitatively. Often this arises in prison settings.                                                                                                                                                                                                                                                |
| Forced labor                                                   | If officials require that people do labor against their will, often without much, if any, compensation. Often this arises in prison settings.                                                                                                                                                                                                                                  |
| Forfeiture                                                     | If someone was forced to give up things they owned (e.g., a car or home) as a result of a law, contract, or arrest.                                                                                                                                                                                                                                                            |
| Foster care (benefits, training)                               |                                                                                                                                                                                                                                                                                                                                                                                |
| Funding                                                        | If funding is relevant to the case, e.g. funding being revoked, sources of funding.                                                                                                                                                                                                                                                                                            |
| Good time                                                      | If someone seeks credit for good behavior while incarcerated that would reduce their total sentence length.                                                                                                                                                                                                                                                                    |
| Government services                                            | If the case is about government services. This is broadly defined, and can include things such as healthcare (e.g., gender-affirming surgery) or transportation.                                                                                                                                                                                                               |
| Grievance procedures                                           | If the process or structure for handling complaints, internal disputes, etc. is inadequate, meaning that people cannot effectively voice their frustrations. Often this arises in prison settings.                                                                                                                                                                             |
| Groundwater                                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Habeas Corpus                                                  | If someone seeks last resort review of their criminal conviction after exhausting all their direct appeal options.                                                                                                                                                                                                                                                             |
| Habilitation (training/treatment)                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Housing                                                        | If the challenge is about the availability or quality of housing generally. Housing can be defined broadly and may apply, for instance, to prison cells. It also applies to more obvious cases like access to rent-stabilized apartments.                                                                                                                                      |
| Housing assistance                                             | If the case concerns housing programs from the government. For example, the plaintiffs might allege that the housing programs are inadequate (amount, burdensome requirements) or that the programs are rejected by landlords (who prefer full-paying tenants).                                                                                                                |
| Improper treatment of mentally ill suspects                    | If there was improper treatment of suspects who have a mental health condition. A common allegation is that the emergency response, usually a police officer (or several), caused a situation to escalate with someone having a mental health crisis and that a crisis responder would have been able to manage the situation more effectively.                                |
| Improper use of canines                                        | If the police deployed police dogs (either drug-detection or attack dogs) in an allegedly unlawful manner.                                                                                                                                                                                                                                                                     |
| Inadequate citizen complaint investigations and procedures     | If a government entity does not properly look into incidents that citizens raise or have the right processes to do so on a regular basis. This is distinct from grievance procedures, which are more confined to the prison setting.                                                                                                                                           |
| Incident/accident reporting & investigations                   | If an entity (government or private) does not look into incidents on its own, without persons raising issues. This also applies even if someone does raise the issue, and it can apply to private corporations.                                                                                                                                                                |
| Individualized planning                                        |                                                                                                                                                                                                                                                                                                                                                                                |
| Informed consent/involuntary medication                        | If someone is being given medical treatment or medicine against their will or without all the proper information to make an educated decision.                                                                                                                                                                                                                                 |
| International law                                              | If the case involves laws from other countries outside of the U.S., or if it involves the international laws, such as those from international organizations like the United Nations or international treaties.                                                                                                                                                                |
| Juveniles                                                      | If the issue at stake affects young people. Often this arises in cases like child welfare disputes or when constitutional challenges are made to criminal laws that may treat younger criminal defendants too harshly.                                                                                                                                                         |
| Language access/needs                                          | If someone cannot understand information on the basis of a language barrier.                                                                                                                                                                                                                                                                                                   |
| Law library access                                             | If an incarcerated person cannot access legal resources (e.g., textbooks, computers) needed to help them plead their case(s) in court.                                                                                                                                                                                                                                         |
| LGBTQ+                                                         | If someone's sexual orientation or transgender status is at issue or a relevant factor in alleged discrimination.                                                                                                                                                                                                                                                              |
| Library (non-law) access                                       | If an incarcerated person cannot access non-legal resources (e.g., leisure reading).                                                                                                                                                                                                                                                                                           |
| Loss or damage to property                                     | If someone's belongings have disappeared or are damaged.                                                                                                                                                                                                                                                                                                                       |
| Mail                                                           | If someone is not able to access their mail or if their mail is being intercepted improperly. Often this comes up in prison settings.                                                                                                                                                                                                                                          |
| Marriage                                                       | If someone's ability to marry freely is at stake.                                                                                                                                                                                                                                                                                                                              |
| Navigable waters                                               | If the dispute concerns large bodies of waters (e.g., rivers, lakes). This comes up most frequently in environmental litigation or disputes about borders.                                                                                                                                                                                                                     |
| Neglect by staff                                               | If a person's needs are not met because the staff is not giving them due care. This often involves someone who is incarcerated.                                                                                                                                                                                                                                                |
| Other                                                          |                                                                                                                                                                                                                                                                                                                                                                                |
| Other Banking                                                  |                                                                                                                                                                                                                                                                                                                                                                                |
| Over/Unlawful Detention                                        | If someone has been arrested and is kept in jail or prison despite the fact that they should have been allowed to be free.                                                                                                                                                                                                                                                     |
| Parents (visitation, involvement)                              | If someone, often incarcerated or institutionalized, is attempting to allow for their parents to visit them, or if their parents are either too involved or not involved enough in their affairs. This often will come up in cases involving juveniles.                                                                                                                        |
| Parking                                                        | If someone is having difficulty accessing parking. This often comes up in disability rights settings.                                                                                                                                                                                                                                                                          |
| Parole grant/revocation                                        | If the case involves someone attempting to (re)obtain parole.                                                                                                                                                                                                                                                                                                                  |
| Pattern or Practice                                            | If an entity is alleged to consistently engage in unlawful behavior.                                                                                                                                                                                                                                                                                                           |
| Payment for care                                               | If someone receives treatment (often health or mental health), and how they pay or what they can afford is at issue.                                                                                                                                                                                                                                                           |
| Pepper/OC spray                                                | If police or prison officials are accused of improper use of pepper spray.                                                                                                                                                                                                                                                                                                     |
| Personal injury                                                | If someone alleges that they have sustained injuries to their person.                                                                                                                                                                                                                                                                                                          |
| Petroleum and petroleum byproducts                             |                                                                                                                                                                                                                                                                                                                                                                                |
| Phone                                                          | If someone seeks access to phones (to make calls).                                                                                                                                                                                                                                                                                                                             |
| Placement in detention facilities                              | If there is a question of whether someone should be placed in specific detention centers (or those centers at all).                                                                                                                                                                                                                                                            |
| Placement in mental health facilities                          | If there is a dispute as to whether someone should be placed (or where they should be placed) in mental health care facilities.                                                                                                                                                                                                                                                |
| Placement in shelters                                          | If there is a dispute as to whether someone should be put into shelters for homeless people.                                                                                                                                                                                                                                                                                   |
| Poverty/homelessness                                           | If someone's low-income status or lack of a home is a factor in the reason the case has been brought.                                                                                                                                                                                                                                                                          |
| Predatory lending                                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Prison Rape Elimination Act                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Protective custody                                             |                                                                                                                                                                                                                                                                                                                                                                                |
| Public assistance grants                                       |                                                                                                                                                                                                                                                                                                                                                                                |
| Public benefits (includes, e.g., in-state tuition, govt. jobs) |                                                                                                                                                                                                                                                                                                                                                                                |
| Quality of representation                                      |                                                                                                                                                                                                                                                                                                                                                                                |
| Racial profiling                                               |                                                                                                                                                                                                                                                                                                                                                                                |
| Racial segregation                                             |                                                                                                                                                                                                                                                                                                                                                                                |
| Reasonable Accommodations                                      |                                                                                                                                                                                                                                                                                                                                                                                |
| Reasonable Modifications                                       |                                                                                                                                                                                                                                                                                                                                                                                |
| Reassessment and care planning                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| Record-keeping                                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| Records Disclosure                                             |                                                                                                                                                                                                                                                                                                                                                                                |
| Recreation / Exercise                                          |                                                                                                                                                                                                                                                                                                                                                                                |
| Rehabilitation                                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| Relative caretakers                                            |                                                                                                                                                                                                                                                                                                                                                                                |
| Religious programs / policies                                  |                                                                                                                                                                                                                                                                                                                                                                                |
| Restraints : chemical                                          |                                                                                                                                                                                                                                                                                                                                                                                |
| Restraints : physical                                          |                                                                                                                                                                                                                                                                                                                                                                                |
| Retail Shopping                                                |                                                                                                                                                                                                                                                                                                                                                                                |
| Retaliation                                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Road construction                                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Sanitation / living conditions                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| School/University Facilities                                   |                                                                                                                                                                                                                                                                                                                                                                                |
| School/University policies                                     |                                                                                                                                                                                                                                                                                                                                                                                |
| Screen readers and similar accessibility devices               |                                                                                                                                                                                                                                                                                                                                                                                |
| Search policies                                                |                                                                                                                                                                                                                                                                                                                                                                                |
| Sex offender regulation                                        |                                                                                                                                                                                                                                                                                                                                                                                |
| Sexual abuse by residents/inmates                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Sex w/ staff; sexual harassment by staff                       |                                                                                                                                                                                                                                                                                                                                                                                |
| Siblings (visitation, placement)                               |                                                                                                                                                                                                                                                                                                                                                                                |
| Sidewalks                                                      |                                                                                                                                                                                                                                                                                                                                                                                |
| Solitary confinement/Supermax (conditions or process)          |                                                                                                                                                                                                                                                                                                                                                                                |
| Special education                                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Staff (number, training, qualifications, wages)                |                                                                                                                                                                                                                                                                                                                                                                                |
| Sterilization/sexual rights                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Strip search policy                                            |                                                                                                                                                                                                                                                                                                                                                                                |
| Suicide prevention                                             |                                                                                                                                                                                                                                                                                                                                                                                |
| Terrorism/Post 9-11 issues                                     |                                                                                                                                                                                                                                                                                                                                                                                |
| Testing                                                        |                                                                                                                                                                                                                                                                                                                                                                                |
| Test or device                                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| Threatened/endangered fauna                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Threatened/endangered flora                                    |                                                                                                                                                                                                                                                                                                                                                                                |
| Timeliness of case assignment                                  |                                                                                                                                                                                                                                                                                                                                                                                |
| Torture                                                        |                                                                                                                                                                                                                                                                                                                                                                                |
| Totality of conditions                                         |                                                                                                                                                                                                                                                                                                                                                                                |
| Transportation                                                 |                                                                                                                                                                                                                                                                                                                                                                                |
| TTY/Close Captioning/Videophone/etc.                           |                                                                                                                                                                                                                                                                                                                                                                                |
| Underground Storage Tank (UST) leakage                         |                                                                                                                                                                                                                                                                                                                                                                                |
| Visiting                                                       |                                                                                                                                                                                                                                                                                                                                                                                |
| Voting                                                         |                                                                                                                                                                                                                                                                                                                                                                                |
| Voting: Physical/Effective Access                              |                                                                                                                                                                                                                                                                                                                                                                                |
| Wait lists                                                     |                                                                                                                                                                                                                                                                                                                                                                                |
| Watchlist                                                      |                                                                                                                                                                                                                                                                                                                                                                                |
| Website                                                        |                                                                                                                                                                                                                                                                                                                                                                                |
| Work release or work assignments                               |                                                                                                                                                                                                                                                                                                                                                                                |
| Youth / Adult separation                                       |                                                                                                                                                                                                                                                                                                                                                                                |

```
                                                                                                                  |
```

### Crowding

These issues concern prison and jail conditions regarding the number of people.

| Value                    | Description                                                                                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crowding / caseload      | If the prison or jail generally has too many people or if there are too many cases to process such that people are not processed in a timely fashion.     |
| Post-PLRA Population Cap | If there are challenges seeking a hard cap on the amount of people who can be in a prison, after the passage of the Prison Litigation Reform Act of 1996. |
| Pre-PLRA Population Cap  | Same as above but prior to the passage of the Prison Litigation Reform Act.                                                                               |

### Discrimination-area

| Value                                                                                           | Description |
| ----------------------------------------------------------------------------------------------- | ----------- |
| Accommodation / Leave                                                                           |             |
| Contracting                                                                                     |             |
| Demotion                                                                                        |             |
| Discharge / Constructive Discharge / Layoff                                                     |             |
| Discipline                                                                                      |             |
| Harassment / Hostile Work Environment                                                           |             |
| Hiring                                                                                          |             |
| Housing Sales/Rental                                                                            |             |
| Insurance                                                                                       |             |
| Lending                                                                                         |             |
| Medical Exam / Inquiry                                                                          |             |
| Other Conditions of Employment (including assignment, transfer, hours, working conditions, etc) |             |
| Pay / Benefits                                                                                  |             |
| Promotion                                                                                       |             |
| Seniority                                                                                       |             |
| Sports                                                                                          |             |
| Steering                                                                                        |             |
| Testing                                                                                         |             |
| Training                                                                                        |             |
| Zoning                                                                                          |             |

### Discrimination-basis

The basis of the discriminatory conduct at issue in the case, i.e. the kind of characteristic or behavior that causes a defendant to mistreat a plaintiff.

| Value                                       | Description                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Age discrimination                          | A person's age (often youth or elderly age)                                                                                                                                                                                                                                                                             |
| Disability (inc. reasonable accommodations) | A person's disability. This could be the mere fact of having a disability, a specific disability, or requesting reasonable accommodations.                                                                                                                                                                              |
| Family discrimination                       |                                                                                                                                                                                                                                                                                                                         |
| Gender identity                             | A person's gender identity. For example, if someone alleges that they were mistreated or denied benefits because they were non-binary or transgender.                                                                                                                                                                   |
| Immigration status                          | If a person was perhaps not a U.S. citizen, or they were undocumented.                                                                                                                                                                                                                                                  |
| Language discrimination                     | A person spoke a specific language (or did not speak English). If this issue is included, there is likely a corresponding issue from the [#language](#language "mention") bucket.                                                                                                                                       |
| Military status discrimination              | Whether a person was a veteran, for instance                                                                                                                                                                                                                                                                            |
| National origin discrimination              | What country a person was from. If this issue is included, there is likely a corresponding issue from the [#national-origin-ethnicity](#national-origin-ethnicity "mention") bucket.                                                                                                                                    |
| Pregnancy discrimination                    | If a person was pregnant                                                                                                                                                                                                                                                                                                |
| Race discrimination                         | A person's race. If this issue is included, there is likely a corresponding issue from the [#race](#race "mention") bucket.                                                                                                                                                                                             |
| Religion discrimination                     | A person's religion                                                                                                                                                                                                                                                                                                     |
| Sex discrimination                          | <p>A person's sex or gender. For example, if someone alleges that they were denied equal treatment because they were a woman rather than a man.<br><br>If this issue is included, there should be a corresponding issue from the <a data-mention href="#affected-sex-or-gender">#affected-sex-or-gender</a> bucket.</p> |
| Sexual orientation                          | A person's sexual orientation. For example, if someone is a member of the LGBTQ+ community.                                                                                                                                                                                                                             |

### Race

If the dispute involves allegations of racial discrimination, the race of the people facing discrimination.

The possible strings for issues in this bucket are:

* American Indian/Alaskan Native
* Asian/Pacific Islander
* Black
* White
* Race, unspecified

`"Race, unspecified"` indicates that the allegations don't include a specific race and instead involve just allegations of general racial discrimination.

### National Origin/Ethnicity

If the dispute involves discrimination on the basis of national origin or ethnicity, the national origin or ethnicity of the people facing discrimination.

The possible strings for this bucket are:

* Arab/Afgani/Middle Eastern
* Hispanic
* Indian
* Other

`"Other"` indicates that the national origin or ethnicity relevant to the case is not one of the ones listed above.

### Language

If the dispute involves allegations of language discrimination, the language used by the people facing discrimination.

The possible strings for issues in this bucket are:

* Arabic
* Chinese
* Spanish
* Vietnamese
* Other

`"Other"` indicates that the language relevant to the case is not one of the ones listed above.

### Affected Sex or Gender

If the dispute involves allegations of sex or gender discrimination, the gender or sex of the people facing discrimination.

The possible strings for issues in this bucket are:

* Female
* Male
* Intersex

### Disability

| Value                         | Description                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| disability, unspecified       | If someone alleges that they are being harmed because of a disability they have but do not specify what disability that is. |
| Hearing impairment            | If someone's disability is that they have difficulty hearing.                                                               |
| Integrated setting            | If someone seeks to be placed in an environment where they can interact with others to the fullest extent possible.         |
| Least restrictive environment | If someone, often a student with special education needs, seeks to be in the classroom as much as possible.                 |
| Mental impairment             | If someone has a disability that limits their ability to process information.                                               |
| Mobility impairment           | If someone has a physical disability that makes movement more difficult.                                                    |
| P\&A access authority         |                                                                                                                             |
| P\&A Associational Standing   |                                                                                                                             |
| Visual impairment             | If someone has difficulty seeing.                                                                                           |
| Opioid disorder/medication    | If someone has an addiction to medication or opioids.                                                                       |

### Mental Disability

If someone has a mental disability that is relevant to the litigation.

| Value                                                    | Description                                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Autism                                                   | If someone has autism.                                                                            |
| Brain injury                                             | If someone has a brain injury.                                                                    |
| Cerebral palsy                                           | If someone has cerebral palsy.                                                                    |
| Depression                                               | If someone has depression.                                                                        |
| Developmental disability without intellectual disability | If someone has a disability that impairs their development but is not an intellectual disability. |
| Down syndrome                                            | If someone has down syndrome                                                                      |
| Intellectual/developmental disability, unspecified       | If someone has a developmental disability that is not specific (or is not listed here).           |
| Learning disability                                      | If someone has a learning disability.                                                             |
| Mental Illness, Unspecified                              | If someone has an unspecified (or unlisted) mental illness.                                       |
| Multiple sclerosis                                       | If someone has multiple sclerosis.                                                                |
| Schizophrenia                                            | If someone has schizophrenia.                                                                     |

### Medical/Mental Health

| Value                                                 | Description                                                                                                                                         |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bed care (including sores)                            | If someone requires bedside assistance or alleges that their bedside assistance is inadequate.                                                      |
| Dementia                                              |                                                                                                                                                     |
| Dental care                                           | If someone requires dental care but is not provided it.                                                                                             |
| End of life choice and DNR orders                     | If the case concerns someone's desire to receive euthanasia or to not be resuscitated in the event that they have suffered serious injuries.        |
| Hepatitis                                             | If someone suffers from hepatitis but perhaps has not received medical care or tests to verify and treat it.                                        |
| HIV/AIDS                                              | If someone has HIV or AIDS and does not receive proper treatment.                                                                                   |
| ICF/MR & HCFA standards                               |                                                                                                                                                     |
| Intellectual/Developmental Disability                 | If someone has an intellectual or developmental disability and does not receive proper care.                                                        |
| Intellectual disability/mental illness dual diagnosis | If someone has both an intellectual disability and a mental illness but does not receive care for either.                                           |
| Medical care, general                                 | If someone generally desires medical care (e.g., general checkups).                                                                                 |
| Medical care, unspecified                             | If someone alleges denial of medical care but does not say what kind of care and does not allege a need for general care.                           |
| Medicare eligibility determination                    | If someone seeks an administrative determination that they qualify for Medicare.                                                                    |
| Medication, administration of                         | If someone alleges that their medical provider improperly administered their medication, perhaps with respect to frequency.                         |
| Mental health care, general                           | If someone makes a general claim for mental health care. This might be a request for a general evaluation, for instance.                            |
| Mental health care, unspecified                       | If someone makes a claim about mental health care without specifying that it is for general purposes.                                               |
| Self-injurious behaviors                              | If someone is engaging in self-harm and alleges that people are not properly supervising them or are causing the conditions that lead to self-harm. |
| Skin Infections                                       | If someone alleges that their skin is infected because of conditions of confinement or unsanitary living spaces.                                    |
| Suicide prevention                                    | If someone alleges that facilities are not doing enough to prevent attempts at suicide.                                                             |
| Tuberculosis                                          | If someone suffers from tuberculosis and seeks medical care.                                                                                        |
| Untreated pain                                        | If someone has a vague pain that has been left untreated.                                                                                           |
| Vision care                                           | If someone seeks vision care.                                                                                                                       |
| Wound care                                            | If someone seeks treatment for their wound.                                                                                                         |

### COVID-19

| Value                                          | Description                                                                                                                                                                            |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Attorneys fees or sanctions ordered            | If the court ordered the defendant to either pay attorneys' fees or imposed sanctions (i.e., financial penalties) on the defendant as a punishment for wrongdoing.                     |
| CDC Guidance ordered implemented               | If the court ordered that the defendant follow CDC guidance.                                                                                                                           |
| Contact tracing ordered                        | If the court ordered contract tracing for COVID-19 positive tests.                                                                                                                     |
| COVID reporting ordered                        | If the court ordered that positive cases of COVID-19 be reported.                                                                                                                      |
| COVID testing ordered/modified                 | If the court ordered that COVID-19 testing be conducted or conducted more frequently.                                                                                                  |
| COVID vaccination ordered                      | If the court ordered that individuals be vaccinated.                                                                                                                                   |
| Exercise/recreation regulated                  | If the court restricted exercise or recreation, often in prison settings, to prevent transmission of COVID-19.                                                                         |
| Independent monitor/inspector imposed/assisted | If the court ordered that a third party inspect or monitor the COVID-19 situation in a space.                                                                                          |
| Inspection ordered/regulated                   | If the court ordered an inspection for COVID-19 cases.                                                                                                                                 |
| Mitigation Denied                              |                                                                                                                                                                                        |
| Mitigation Granted                             |                                                                                                                                                                                        |
| Mitigation Requested                           |                                                                                                                                                                                        |
| Non-retaliation ordered                        |                                                                                                                                                                                        |
| Out-of-cell time regulated                     | If, in prison settings, the time that incarcerated persons could spend outside of the cell was limited to prevent transmission.                                                        |
| Population-Medically vulnerable                | If the court ordered a remedy specific to medically vulnerable persons.                                                                                                                |
| Population reduction/cap                       | If the court ordered a prison to reduce its population or imposes a cap with that effect.                                                                                              |
| PPE-ordered provided to prisoners for free     | If the court ordered that incarcerated persons should be given protective equipment (like masks) for free.                                                                             |
| PPE-ordered worn by staff                      | If the court ordered that staff must wear masks, etc.                                                                                                                                  |
| Programming regulated                          |                                                                                                                                                                                        |
| Quarantine/isolation ordered                   | If the court ordered that COVID-19-positive persons should be required to quarantine or isolate.                                                                                       |
| Release Denied                                 | If the court denied release as a measure to prevent COVID-19 transmission.                                                                                                             |
| Release Granted                                | If the court granted release as a measure to prevent COVID-19 transmission.                                                                                                            |
| Release granted-group                          | If the release granted was as to a group of people or category of persons.                                                                                                             |
| Release granted-individual                     | If the release granted was specific to a person or done on a case-by-case basis.                                                                                                       |
| Release-process created/modified               | If the court ordered that a mechanism for determining release be created.                                                                                                              |
| Release Requested                              | If the plaintiff requested release because of COVID-19.                                                                                                                                |
| Sanitizer/Handsoap ordered made available/used | If the court ordered that a facility provide hand sanitizer or hand soap.                                                                                                              |
| Social distancing ordered                      | If the court ordered that people stay socially distanced.                                                                                                                              |
| Solitary confinement regulated                 | If the court limited when solitary confinement could be imposed.                                                                                                                       |
| Transfer-ordered or process created/modified   | If the court ordered that facilities begin a process for transferring people across facilities or if the facilities themselves created such a process to lower density in some places. |
| Video court ordered                            | If the court ordered that people be allowed to attend their hearings via Zoom or other video conference software.                                                                      |
| Wellness/temperature checks ordered            | If the court ordered that routine checks for wellness and temperature be conducted.                                                                                                    |

### Plaintiff Type

What types of parties were plaintiffs in the case.

| Value                                 | Description                                                                                                     |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| American Indian Tribe                 | A Native tribe                                                                                                  |
| City/County Plaintiff                 | A city or county                                                                                                |
| Closely-held (for profit) corporation | A private corporation that was not publicly traded (i.e., they were owned by a small group, sometimes a family) |
| EEOC Plaintiff                        | The U.S. Equal Employment Opportunity Commission                                                                |
| Non-DOJ federal government plaintiff  | An agency within the federal government that was not the EEOC or Department of Justice (DOJ)                    |
| Non-profit NON-religious organization | A non-profit and non-religious organization                                                                     |
| Non-profit religious organization     | A non-profit religious organization.                                                                            |
| Private Plaintiff                     | An individual person or a private corporation that was not closely held                                         |
| Public (for-profit) corporation       | A public, for-profit corporation                                                                                |
| State Plaintiff                       | A U.S. state                                                                                                    |
| U.S. Dept of Justice plaintiff        | The U.S. Department of Justice (DOJ)                                                                            |

### Defendant-type

What type of parties were defendants in the case.

| Value                                         | Description                                                                                   |
| --------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Bank or credit provider                       | A financial institution                                                                       |
| College/University                            | An institution of higher learning                                                             |
| Corrections                                   | A prison or jail                                                                              |
| Elementary/Secondary School                   | An elementary, middle, or high school                                                         |
| Fire                                          | A fire department                                                                             |
| Hospital/Health Department                    | A hospital or health department                                                               |
| Housing Authority                             | A governmental entity that aims to provide affordable housing                                 |
| Insurer                                       | An insurance company                                                                          |
| Jurisdiction-wide                             | An entity that spans a geographic area. For example, a township, a city, a county, or a state |
| Law-enforcement                               | A law enforcement unit, like a police department                                              |
| Movie Theater or Other Entertainment facility | An entertainment facility                                                                     |
| Multi-family housing provider                 | A multi-family housing provider, often an apartment complex                                   |
| Parks                                         | A park                                                                                        |
| Restaurant                                    | A restaurant                                                                                  |
| Retailer                                      | A retailer, like a bookstore or grocery store                                                 |
| Sanitation/Public Works                       | A public works entity                                                                         |
| Single family housing provider                | A single family housing provider (i.e. it rents entire homes)                                 |
| Transportation                                | A transit authority or transportation provider                                                |

### Type of Facility

| Value                     | Description                                                      |
| ------------------------- | ---------------------------------------------------------------- |
| Government-run            | The facility is run by the government.                           |
| Non-government for-profit | The facility is a non-government space that operates for-profit. |
| Non-government non-profit | The facility is a non-government space that is non-profit.       |

### Benefit Source

| Value                                                                     | Description                                                                                                   |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Adoption Assistance and Child Welfare Act                                 | If someone attempted to obtain subsidies from this act for the purposes of adoption.                          |
| Aid to Families with Dependent Children (AFDC)                            | If someone attempted to obtain financial assistance under this act for children from lower income households. |
| American Rescue Plan (ARP)                                                | If a business attempted to receive money from this act amidst the COVID-19 pandemic.                          |
| CARES Act (Covid-related)                                                 | If someone attempted to obtain money from the CARES Act during the COVID-19 pandemic.                         |
| Comprehensive Employment and Training Act (CETA)                          | If someone attempted to obtain training and employment through this act.                                      |
| DACA (Deferred Action for Childhood Arrivals)                             | If someone attempted to avoid deportation by qualifying for deferred action under this act.                   |
| Earned Income Tax Credit (EITC)                                           | If someone attempted to receive a tax credit under this act.                                                  |
| Families First Coronavirus Response Act (FFRCA)                           | If someone attempted to receive family or medical leave under this act.                                       |
| Food stamps/SNAP                                                          | If someone attempted to receive financial assistance to purchase food via this program.                       |
| Medicaid                                                                  | If someone attempted to qualify for and receive health care under Medicaid.                                   |
| Medicare                                                                  | If someone attempted to qualify for and receive health care under Medicare.                                   |
| Social Security Retirement and Death Benefit                              | If someone attempted to obtain the benefits of their deceased spouse.                                         |
| SSDI                                                                      |                                                                                                               |
| EMTALA (42 U.S.C. § 1395dd)                                               |                                                                                                               |
| SSI                                                                       |                                                                                                               |
| Stewart B. McKinney Homeless Assistance Act, 42 U.S.C.A. §§ 11301 et seq. |                                                                                                               |
| Temporary Assistance for Needy Families (TANF)                            |                                                                                                               |
| Women, Infants, and Children (WIC)                                        |                                                                                                               |

### EEOC-centric

| Value                                              | Description |
| -------------------------------------------------- | ----------- |
| Direct Suit on Merits                              |             |
| EEOC Intervened in Private Suit                    |             |
| Private Party intervened in EEOC suit              |             |
| Private Suit Related / Consolidated with EEOC Suit |             |

### Voting

| Value                                                | Description                                                                                                                           |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Candidate qualifications                             | If there was a dispute as to whether an election could require a candidate meet certain qualifications.                               |
| Challenges to at-large/multimember district/election |                                                                                                                                       |
| Election administration                              | If there was a challenge to how the election was run.                                                                                 |
| Redistricting/district composition                   | If there was a challenge to how districts were drawn.                                                                                 |
| Results test                                         |                                                                                                                                       |
| Vote decision rules                                  |                                                                                                                                       |
| Vote dilution                                        | If there were allegations that voting districts were gerrymandered so as to dilute the vote of a particular group of people.          |
| Voter ID                                             | If there was a dispute about what kinds of identification (if any) that a jurisdiction could require before allowing someone to vote. |
| Voter qualifications                                 | If there was a dispute as to what a jurisdiction required of a voter before allowing them to vote, other than identification.         |
| Voter registration rules                             | If there were procedures or rules that governed how a voter can register.                                                             |

### Death Penalty

| Value                                             | Description                                                                                                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Electric chair                                    | If the case concerns execution by way of electric chair.                                                                                                      |
| Gas Chamber                                       | If the case concerns execution by way of gas chamber.                                                                                                         |
| Hanging                                           | If the case concerns execution by way of hanging.                                                                                                             |
| Lethal Injection - Chemicals Used                 | If the challenge to the use of lethal injection is that the specific chemicals that are used in the mixture are unlawful.                                     |
| Lethal Injection - General                        | If the challenge is generally to lethal injection as a method of execution.                                                                                   |
| Lethal Injection - Staffing (including physician) | If the challenge is that a prison or facility does not have the required experts or physicians to administer the lethal injection.                            |
| Quality of representation                         | If someone who has been sentenced to death asserts that their legal counsel was ineffective in violation of their right to counsel under the Sixth Amendment. |

### Immigration/Border

| Value                                                | Description                                                                                                                                  |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Admission - criteria                                 | What requirements or factors must be considered to allow someone to enter the United States.                                                 |
| Admission - procedure                                | What the process is for admitting someone into the United States.                                                                            |
| Asylum - criteria                                    | What requirements or factors must be considered to grant someone asylum.                                                                     |
| Asylum - procedure                                   | What the process is for granting someone asylum.                                                                                             |
| Border police                                        | Members of law enforcement placed at the border.                                                                                             |
| Border wall                                          | Physical barriers constructed or erected at the border.                                                                                      |
| Constitutional rights                                | Raising constitutional challenges to immigration restrictions.                                                                               |
| Convention against Torture                           | If someone alleges that the denial of their attempt to immigrate (or their detention) violated the international convention against torture. |
| Criminal prosecution                                 | Someone is being criminally prosecuted for attempting to cross the border.                                                                   |
| Cuban/Haitian entrant                                | If the person attempting to enter the country is from Cuba or Haiti.                                                                         |
| Deportation - criteria                               | What requirements or factors must be considered to deport someone.                                                                           |
| Deportation - judicial review                        | The ability of courts to review a deportation decision.                                                                                      |
| Deportation - procedure                              | What process is followed to deport someone.                                                                                                  |
| Detention - conditions                               | The conditions (sanitation, bedding, etc.) in detention spaces or facilities.                                                                |
| Detention - criteria                                 | What requirements or factors must be considered to detain someone who is attempting to enter the country.                                    |
| Detention - procedures                               | What process is followed in detaining someone.                                                                                               |
| Employer sanctions                                   |                                                                                                                                              |
| Employment                                           |                                                                                                                                              |
| Family Separation                                    | If the effect of deportation is that parents and children are separated from each other.                                                     |
| ICE/DHS/INS raid                                     | If immigration authorities conduct raids to find people who are undocumented.                                                                |
| Immigration lawyers                                  | The ability to retain counsel during immigration proceedings.                                                                                |
| Legalization/Amnesty                                 |                                                                                                                                              |
| Refugees                                             | Someone who is forced to flee somewhere on account of violence or unrest.                                                                    |
| Sanctuary city/state                                 | A jurisdiction that makes a general promise not to help deport people.                                                                       |
| Status/Classification                                |                                                                                                                                              |
| Temporary foreign workers program                    |                                                                                                                                              |
| Temporary protected status                           |                                                                                                                                              |
| Temporary visitors                                   |                                                                                                                                              |
| Undocumented immigrants - rights and duties          |                                                                                                                                              |
| Undocumented immigrants - state and local regulation |                                                                                                                                              |
| U.S. citizenship - acquiring                         | The process of and ability to obtain U.S. citizenship.                                                                                       |
| U.S. citizenship - losing                            | The process of and ability to lose U.S. citizenship.                                                                                         |
| Visas - criteria                                     | What requirements or factors must be considered to give someone a visa to temporarily stay in the country.                                   |
| Visas - procedures                                   | What process is followed to give someone a visa to temporarily stay in the country.                                                          |
| Work authorization - criteria                        | What requirements or factors must be considered to give someone work authorization to temporarily stay in the country.                       |
| Work authorization - procedures                      | What process is followed to give someone work authorization to temporarily stay in the country.                                              |

### Content of Injunction

If there is an injunction or injunctive-like relief in the case (see [Outcome](/api-reference-v2p1/objects/case/outcome#relief_natures)), what kinds of behavior the injunction required.

This bucket also includes issues on whether preliminary injunctive relief (including temporary restraining orders) was granted or denied.

| Value                                                     | Description                                                                                                                                                                                                 |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Apology                                                   | If the defendant had to apologize.                                                                                                                                                                          |
| Auditing                                                  | If someone (often a third party or the plaintiff) had to double check data or information gathered by the defendant.                                                                                        |
| Busing                                                    | In school desegregation cases, if part of the remedy was to provide buses to transport students from one area to a school in another area.                                                                  |
| Comply with advertising/recruiting requirements           | If the defendant had to advertise or recruit in specific ways.                                                                                                                                              |
| Develop anti-discrimination policy                        | If the defendant had to come up with a proactive policy to not discriminate in the future.                                                                                                                  |
| Discrimination Prohibition                                | If the defendant was ordered not to discriminate.                                                                                                                                                           |
| Expungement of Employment Record                          | If demerits or marks on someone's employment record should be removed.                                                                                                                                      |
| Follow recruitment, hiring, or promotion protocols        | If someone had to attract new talent (or promote existing talent) based on specific requirements or methods.                                                                                                |
| Goals (e.g., for hiring, admissions)                      |                                                                                                                                                                                                             |
| Hire                                                      | If the defendant had to employ the plaintiff.                                                                                                                                                               |
| Implement complaint/dispute resolution process            | If the defendant had to institute a means of allowing people to file complaints and resolving them.                                                                                                         |
| Magnet school                                             | If the defendant had to establish a magnet school that is not geographically-based but instead can be attended by students from a wider area.                                                               |
| Monitoring                                                | If someone (often the court or a third party) oversaw implementation of certain requirements in an injunction.                                                                                              |
| Monitor/Master                                            | If the court appointed a third party to oversee implementation of certain requirements in an injunction.                                                                                                    |
| Neutral/Positive Reference                                | If an employer cannot give a negative reference and instead must at least provide a neutral one.                                                                                                            |
| Other requirements regarding hiring, promotion, retention |                                                                                                                                                                                                             |
| Position Restored                                         |                                                                                                                                                                                                             |
| Post/Distribute Notice of Rights / EE Law                 |                                                                                                                                                                                                             |
| Preliminary relief denied                                 | If the court denied the plaintiff's request for a preliminary injunction or temporary restraining order.                                                                                                    |
| Preliminary relief granted                                | If the court granted a preliminary injunction or temporary restraining order.                                                                                                                               |
| Preliminary relief request withdrawn/mooted               | If the court did not actually weigh in on the request for a preliminary injunction because either the plaintiff rescinded their request or because there was no longer a need for a preliminary injunction. |
| Promotion                                                 | If the employer had to promote the employee.                                                                                                                                                                |
| Provide antidiscrimination training                       | If the defendant must now train their employees in how to not discriminate. For example, this might come up in police or prison contexts.                                                                   |
| Reasonable Accommodation                                  | If the defendant must provide accommodations that help a person with a disability access services/buildings/etc.                                                                                            |
| Receivership                                              | If the court appointed a different kind of third party (receiver, rather than monitor or master) to oversee implementation of the injunction.                                                               |
| Recordkeeping                                             | If the defendant must now keep more detailed records regarding incidents or daily occurrences.                                                                                                              |
| Reinstatement                                             | If someone must be allowed to return to their position/employment.                                                                                                                                          |
| Remedial education                                        | If the defendant was required to provide or undergo additional education to make up for prior lacking education.                                                                                            |
| Reporting                                                 | If the defendant is now required to issue routine reports detailing progress on complying with the injunction.                                                                                              |
| Required disclosure                                       | If the defendant must now disclose incidents or occurrences as they happen.                                                                                                                                 |
| New Election                                              | If the court orders that a new vote be held.                                                                                                                                                                |
| Retaliation Prohibition                                   | If the defendant is ordered to not retaliate against the plaintiff for raising issues or complaints.                                                                                                        |
| Retroactive Seniority                                     | If the court orders that someone be properly credited for the amount of time they have worked.                                                                                                              |
| Student assignment                                        | If students must be placed in particular schools in a specific way.                                                                                                                                         |
| Training                                                  | If the employer must provide more training to their employees to remedy previously lacking training that led to violations.                                                                                 |
| Utilize objective hiring/promotion criteria               | If the employer now must use non-subjective criteria (e.g., years worked, relevant experience) rather than personal feelings about a candidate.                                                             |
| Utilize objective job description                         | If someone must provide a job description with requirements listed that are non-subjective.                                                                                                                 |
| Warrant/order for search or seizure                       | If the court orders that someone or something be searched or seized.                                                                                                                                        |
| State Statute Struck Down                                 | If a state statute is deemed to be unconstitutional or otherwise in violation of the law.                                                                                                                   |
| Redistricting                                             | If voting districts are determined to be unlawful and the court orders that they be redrawn.                                                                                                                |
| Vote Counting                                             | If the vote is close and the court orders a manual count.                                                                                                                                                   |
| Voting Process Changes                                    | If the court orders changes to how the vote is held (e.g., if early voting is restricted or expanded).                                                                                                      |
| Voter Registration                                        | If the process for registering voters is ordered to expand or contract.                                                                                                                                     |

## custom\_issues

(*array\[string]*)

Case issues that aren't part of the Clearinghouse's predefined choices. For examples of custom issues that have been added to the Clearinghouse, see [Broken mention](broken://pages/hXX3iX1BOyt9UBOVvAj6).

## plaintiff\_type

(*array\[string]*)

Issues that fall under [#plaintiff-type](#plaintiff-type "mention"). [#plaintiff-type](#plaintiff-type "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#plaintiff-type](#plaintiff-type "mention").

## defendant\_type

(*array\[string]*)

Issues that fall under [#defendant-type](#defendant-type "mention"). [#defendant-type](#defendant-type "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#defendant-type](#defendant-type "mention").

## facility\_type

(*array\[string]*)

Issues that fall under [#type-of-facility](#type-of-facility "mention"). [#type-of-facility](#type-of-facility "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#type-of-facility](#type-of-facility "mention").

## constitutional\_clause

(*array\[string]*)

Issues that fall under [#constitutional-clause](#constitutional-clause "mention"). [#constitutional-clause](#constitutional-clause "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#constitutional-clause](#constitutional-clause "mention").

## special\_case\_type

(*array\[string]*)

Issues that fall under [#special-case-type](#special-case-type "mention"). [#special-case-type](#special-case-type "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#special-case-type](#special-case-type "mention").

## content\_of\_injunction

(*array\[string]*)

Issues that fall under [#content-of-injunction](#content-of-injunction "mention"). [#content-of-injunction](#content-of-injunction "mention") issues appear both in this array and in the [#issues](#issues "mention") array. For more information, see [#content-of-injunction](#content-of-injunction "mention").


# Key Dates

## filing\_date

(*string*)

The date the case was filed, in the format `"YYYY-MM-DD"`. This is generally the date of the (first) complaint.

If `filing_date` is empty, we do not know when the case was originally filed or the case was not filed (see [#never\_filed](#never_filed "mention")). (Also check the [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).)

## filing\_year

(*number*)

The year the case was filed, in the format `YYYY`. If `filing_date` is not empty, then `filing_year` should equal the year of `filing_date`.

See [#filing\_date](#filing_date "mention") for more information.

## never\_filed

(*boolean*)

If the case was never filed, this field is `True`.

If `never_filed` is `True`, both `filing_date` and `filing_year` should be empty.

## settlement\_judgment\_date

(*string*)

The date of the first judgment or settlement in the case, in the format `"YYYY-MM-DD"`.

If `settlement_judgment_date` is empty, then there may not be a judgment or settlement in the case (yet). (Also check the [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).)

## settlement\_judgment\_year

(*number*)

The year of the first judgment or settlement in the case, in the format `YYYY`. If `settlement_judgment_date` is not empty, then `settlement_judgment_year` should equal the year of `settlement_judgment_date`.

See [#settlement\_judgment\_date](#settlement_judgment_date "mention") for more information.

## order\_start\_year

(*number*)

The first year of an injunction or injunctive-like relief, in the format `YYYY`. This applies only if there was an injunction or injunctive-like relief in the case.

## order\_end\_year

(*number*)

The last year of an injunction or injunctive-like relief, in the format `YYYY`. This applies only if there was an injunction or injunctive-like relief in the case.

If an injunction is a permanent injunction, then there will be no `order_end_year` (and [#permanent\_injunction](#permanent_injunction "mention") will be `true`). If the injunction was still in effect at the time the case's metadata was updated, then there `order_end_year` will be empty.

## injunction\_duration

(*string*)

The duration, in months, that an injunction (preliminary or permanent) or temporary restraining order lasted.

If `injunction_duration` is empty, it may be because there was no injunction in the case or because the injunction is ongoing (and has no end date yet).

## permanent\_injunction

(*boolean*)

Whether the injunction or injunctive-like relief was set to last forever (i.e. there is no end date). An injunction is typically a court order requiring a party to do (or stop doing) a specific action.

If `permanent_injunction` is `true`, then [#order\_end\_year](#order_end_year "mention") will both be empty.

## terminating\_date

(*string*)

The last date of any activity in a case, in the format `"YYYY-MM-DD"`. "Any activity" includes things like ongoing injunctions, monitoring, waiting for status reports, and other events that might happen after a judgment has been issued or the parties reach a settlement.

If `terminating_date` is empty, then the case has not ended yet or we do not know when the case ended. (Also check the [Case Status](/api-reference-v2p1/objects/case/case-status#case_status).)

If `terminating_date` is not empty, then `case_ongoing` should be either "No" or "No reason to think so." See [Case Details](/api-reference-v2p1/objects/case/case-details#case_ongoing) for more information.

## closing\_year

(*number*)

The last year of any activity in a case, in the format `YYYY`. If `terminating_date` is not empty, then `closing_year` should equal the year of `terminating_date`.

See [#terminating\_date](#terminating_date "mention") for more information.


# Parties

In a lawsuit, a party is a person or entity that takes part in the lawsuit.

## Plaintiffs

A plaintiff is someone on the side that brings the lawsuit. For Clearinghouse cases that don't fit the typical adversarial lawsuit model (e.g. settlements), the plaintiff is the person or entity that initiated the action (e.g. the person who initiated settlement negotiations).

### plaintiff\_description

(*string*)

A description of the people or entities that brought the lawsuit. We generally avoid including names of individuals (e.g. "an incarcerated person"), but we do sometimes include organization names (e.g. "U.S. Department of Justice").

If the plaintiffs sought a class action (see [#class\_action\_sought](#class_action_sought "mention")), then `plaintiff_description` is typically the class definition (abridged if necessary).

### pro\_se\_status

(*string*)

Whether the case had a plaintiff that was *pro se*. A plaintiff without a lawyer is known as a *pro se* plaintiff.

| Value   | Description                                                                                                                                                                |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null    | This field has not been set yet. This is likely because the case's metadata is not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status). |
| Yes     | The plaintiff was *pro se*, i.e. without a lawyer.                                                                                                                         |
| No      | The plaintiff was not *pro se*, i.e. represented by a lawyer.                                                                                                              |
| Unknown | We don't know if the plaintiff was represented by a lawyer.                                                                                                                |

### public\_interest\_lawyer

(*string*)

Whether any lawyer representing one of the parties is a public interest lawyer. "Public interest" encompasses many things, and is generally thought to concern the protection of individual rights, advancement of justice, and improvements for the good of the general public. Government lawyers count if the government is the plaintiff, but *not* if the government is the defendant.

| Value   | Description                                                                                                                                                                |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null    | This field has not been set yet. This is likely because the case's metadata is not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status). |
| Yes     | At least one lawyer representing one of the parties is a public interest lawyer.                                                                                           |
| No      | No lawyer representing a party is a public interest lawyer.                                                                                                                |
| Unknown | We don't know if the lawyers are public interest lawyers.                                                                                                                  |

If there are any organizations in the [#attorney\_orgs](#attorney_orgs "mention") array, then `public_interest_lawyer` will be `"Yes"`.

### attorney\_orgs

(*array\[string]*)

Organizations that represent the plaintiff. The possible organizations for `attorney_orgs` come from a predefined list of public interest organizations.

For a full list, including a description and link for each organization, see [the Clearinghouse page on attorney organizations](https://clearinghouse.net/attorney-orgs).

### class\_action\_sought

(*string*)

Whether a party sought a class action lawsuit. A class action is a type of lawsuit where one or more plaintiffs can sue on behalf of a larger group, known as a "class." As part of a class action, the plaintiffs must ask the court to "certify" a class. In rare cases, this may apply to defendants; that is, the court may certify a class for the defendants.

| Value   | Description                                                                                                                                                                |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null    | This field has not been set yet. This is likely because the case's metadata is not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status). |
| Yes     | The plaintiffs sought a class action.                                                                                                                                      |
| No      | The plaintiffs did not seek a class action.                                                                                                                                |
| Unknown | We don't know if the plaintiffs sought a class action.                                                                                                                     |

### class\_action\_granted

(*string*)

The status/result of the class action that was sought. For more information on class actions, see [#class\_action\_sought](#class_action_sought "mention").

| Value                | Description                                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null                 | This field has not been set yet. This is likely because the case's metadata is not complete – see [Case Status](/api-reference-v2p1/objects/case/case-status#case_status). |
| Granted              | The court granted the class action. This includes certifying the class for litigation and for just settlement.                                                             |
| Denied               | The court denied the class action, and so no class was certified.                                                                                                          |
| Pending              | The plaintiffs sought a class action, but the court has not ruled on it (yet).                                                                                             |
| Withdrawn            | The plaintiffs sought a class action, but they withdrew the motion before the court ruled on it.                                                                           |
| Mooted before ruling | The plaintiffs sought a class action, but before the court could rule on it, something happened so as to render that decision irrelevant.                                  |
| Not sought           | The plaintiffs did not seek a class action.                                                                                                                                |
| Unknown              | We don't know if the court granted a class action.                                                                                                                         |

## Defendants

A defendant is someone who is sued in a lawsuit. For Clearinghouse cases that don't fit the typical adversarial lawsuit model (e.g. settlements), the defendant is the person or entity who the action is brought against. The defendant is typically someone whose behavior the plaintiffs seek to change.

### case\_defendants

(*array\[object]*)

An array of `Defendant` objects. See [Defendant](/api-reference-v2p1/objects/defendant).


# Dockets and Case Numbers

A case can be identified by its docket number. In some cases, we also have other identifying numbers associated with a case.

## non\_docket\_case\_number

(*string*)

A case number associated with the case that is not a docket number. This is often used for U.S. Department of Justice (DOJ) and Equal Employment Opportunity Commission (EEOC) investigations.

## non\_docket\_case\_number\_type

(*string*)

| Value | Description                                                                                                                                                                  |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null  | There is no non-docket case number.                                                                                                                                          |
| DJ    | U.S. Department of Justice                                                                                                                                                   |
| EEOC  | U.S. Equal Employment Opportunity Commission                                                                                                                                 |
| OCR   | U.S. Department of Education, Office of Civil Rights                                                                                                                         |
| other | The non-docket case number comes from an organization that is not in this list. See [#non\_docket\_case\_number\_type\_other](#non_docket_case_number_type_other "mention"). |

## non\_docket\_case\_number\_type\_other

(*string*)

The non-docket case number's type, if `non_docket_case_number_type` is `"other"`. Otherwise, this will be an empty string.


# Documents

## available\_documents

(*array\[string]*)

A list of the types of documents available in the Clearinghouse for this case. For example, if the array includes `"Complaint (any)"`, then there is at least one document that is a complaint for the case.

| Value                                  | Description                                                                                                                                                                                                                                        |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Any published opinion                  | A judicial opinion or order that has been published in a reporter. For more information on what it means for an opinion to be published, see [Citations](/api-reference-v2p1/objects/document/citations).                                          |
| Complaint (any)                        | A document that contains the facts underlying the lawsuit, the plaintiff's legal claims, and what the plaintiff would like the court to do. A complaint often starts a case.                                                                       |
| Injunctive (or Injunctive-like) Relief | A document that sets forth how a party will change its behavior. This could be a court order or a settlement.                                                                                                                                      |
| Monetary Relief                        | A document that awards monetary relief (e.g. damages) to a party.                                                                                                                                                                                  |
| Non-settlement Outcome                 | A document that provides an outcome to a case that is not a settlement, e.g. a judgment.                                                                                                                                                           |
| Trial Court Docket                     | The trial court docket for the case. This includes both dockets saved as PDF documents and dockets saved as Docket Entry objects. For more about the different ways we save dockets, see [Docket Entry](/api-reference-v2p1/objects/docket-entry). |
| U.S. Supreme Court merits opinion      | A U.S. Supreme Court opinion that contains legal analysis (as opposed to e.g. only denying certiorari).                                                                                                                                            |
| None of the above                      | We have no documents that fall into the above categories.                                                                                                                                                                                          |


# Summaries

## summary

(*string*)

A summary of the case, formatted in HTML.

## summary\_published\_date

(*string*)

The date and time that the summary was published, in the format `"YYYY-MM-DDTHH:MM:[ss[.uuuuuu]][TZ]"`. The time zone (`TZ`) will be either `-5:00` for Eastern Standard Time or `-4:00` for Eastern Daylight Time.

## summary\_updated\_date

(*string*)

## summary\_short

(*string*)

An abridged summary of the case.

## summary\_tiny

(*string*)

A 1-2 sentence summary of the case. We use tiny summaries to post tweets on the [Clearinghouse's Twitter account](https://twitter.com/civilrightsch) (where we append a link to the case), so tiny summaries are limited to 257 characters.

### summary\_authors

*(array \[string])*

An array of strings with summary author first and last name and the date they wrote the summary in parentheses.


# Case Status

These fields relate to the Clearinghouse's internal information about a case (as opposed to information about how the case is proceeding in the real world).

## case\_status

(*string*)

The `case_status` indicates where a case is in the process of filling out the summary and metadata.

Possible values:

| Value               | Description                                                                                                                                                                                                                 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Approved            | The case's summary and metadata are complete.                                                                                                                                                                               |
| Coding Complete     | The case's metadata is complete, but the summary may not have been published yet and is likely awaiting internal review.                                                                                                    |
| In Process (Public) | The case has been added to the Clearinghouse, but work on the summary and metadata has not started or is in progress. There may be a temporary 1-2 sentence summary, but it is likely that there is incomplete information. |

The case status can be helpful in interpreting empty values for some fields. For example, if a case's `order_start_year` is empty and `case_status` is "In Process (Public)", then it's possible the case did have an injunction (or injunctive-like order) but we have yet to enter in that piece of metadata. On the other hand, if `order_start_year` is empty, `case_ongoing` is "No", and `case_status` is "Approved", then there was no injunction (or injunctive-like order) in the case.

## last\_checked\_date

(*string*)

The date that the case was last checked – i.e. the case is up to date as of the `last_checked_date`. This string is in the format `"YYYY-MM-DDTHH:MM:ssTZ"`.

## docket\_status

(*string*)

The status of the main docket for the case.

| Value                         | Description                                                                                                                                                                                          |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null                          | This field has not been set yet. This is likely because the case's metadata is not complete – see [#case\_status](#case_status "mention").                                                           |
| Complete as of retrieval date | The docket is complete up to the date it was last retrieved. The docket entries may be present as [Docket Entry](/api-reference-v2p1/objects/docket-entry) objects or as one of the case's document. |
| Incomplete                    | We have only part of the docket.                                                                                                                                                                     |
| None                          | We have no docket for this case. This might be because there is no docket or because we do not have access to the docket.                                                                            |


# Pagination Urls

## case\_documents\_url

(*array\[string]*)

A URL that returns a **paginated list of documents associated with this case**. Use this link to retrieve all related documents to the case. For details on navigating pages, see the [Pagination Guide](/api-reference-v2p1/new-features/pagination). See [Docket](/api-reference-v2p1/objects/docket).

## case\_dockets\_\_url

(*array\[string]*)

A URL that returns a **paginated list of dockets associated with this case**. Use this link to retrieve all related dockets to the case. For details on navigating pages, see the [Pagination Guide](/api-reference-v2p1/new-features/pagination). See [Docket](/api-reference-v2p1/objects/docket) to learn more about the `Docket` object

## case\_resources\_\_url

(*array\[string]*)

A URL that returns a **paginated list of resources associated with this case**. Use this link to retrieve all related resources to the case. For details on navigating pages, see the [Pagination Guide](/api-reference-v2p1/new-features/pagination).


# Defendant

When adding entries for defendants, we record only the "real party in interest" – that is, who is really being sued. This may be different from the names listed on a complaint, as sometimes a suit will be filed naming an individual who represents or works for a government agency, but it’s the agency that defends the lawsuit, obeys the injunction, and pays the damages.

For example, if a plaintiff sues a state, the state's governor, and the state's attorney general, we usually would record only the state as a defendant.

## name

(*string*)

The name of the "real party in interest" – typically the institution being sued or the institution represented by the individuals being sued. Sometimes, this might also be the title of a position that a person holds. In very rare cases, `name` will refer to an actual person.

## institution

(*string*)

The institution or agency that took the action that formed the basis of the lawsuit. If this is the same as [#name](#name "mention"), then `institution` should be an empty string.

## institution\_city

(*string*)

The city of the defendant's location. This is *not* where the challenged action(s) took place. If the defendant is a state or federal entity (i.e. applies to the whole state or country), then `institution_city` is an empty string.

## institution\_county

(*string*)

The county of the defendant's location. This is *not* where the challenged action(s) took place. The choices for this field are limited to the counties in the case's state (see [Case Details](/api-reference-v2p1/objects/case/case-details#state)). If the defendant is a state or federal entity (i.e. applies to the whole state or country), then `institution_county` is `null`.

## institution\_alt\_state

(*string*)

The state of the defendant's location if the state is different from the case's state (see [Case Details](/api-reference-v2p1/objects/case/case-details#state)). If the defendant's state is the same as the case's state is `null`. If the defendant is a federal entity, then `institution_alt_state` is `"- United States (national) -"`. Similarly, if the defendant is an international entity, then `institution_alt_state` is `"- International -"`.

For a full list of possible states, see [Case Details](/api-reference-v2p1/objects/case/case-details#state).

## defendant\_level

(*string*)

The type or category of the defendant in terms of what the defendant governs.

| Value                  | Description                                                                                                                                                                                                                                                                                                 |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null                   | The defendant's level is either not defined or does not fit within one of the Clearinghouse's predefined choices. If it does not fit the predefined choices, the defendant's level may be defined as `defendant_level_other` (see [Defendant](/api-reference-v2p1/objects/defendant#defendant_level_other)) |
| City                   | A city or city-level entity.                                                                                                                                                                                                                                                                                |
| County                 | A county or county-level entity.                                                                                                                                                                                                                                                                            |
| Federal                | A country or federal entity.                                                                                                                                                                                                                                                                                |
| Non-profit or advocacy | A nonprofit or advocacy organization that is not a governmental body.                                                                                                                                                                                                                                       |
| Political Party        | A political party.                                                                                                                                                                                                                                                                                          |
| Private Entity/Person  | A private entity or individual person.                                                                                                                                                                                                                                                                      |
| Regional               | An entity associated with a region that is not a city, county, state, or country.                                                                                                                                                                                                                           |
| School District        | A public school district.                                                                                                                                                                                                                                                                                   |
| State                  | A state or state entity.                                                                                                                                                                                                                                                                                    |
| Tribe                  | An indigenous tribe.                                                                                                                                                                                                                                                                                        |
| Union                  | A labor union.                                                                                                                                                                                                                                                                                              |

Note: This is different from [the "Defendant-type" case issue](/api-reference-v2p1/objects/case/issues#defendant-type).

## defendant\_level\_other

(*string*)

The type or category of the defendant in terms of what the defendant governs if it does not fall under one of the options for [#defendant\_level](#defendant_level "mention").

Note: This is different from [the "Defendant-type" case issue](/api-reference-v2p1/objects/case/issues#defendant-type).


# Docket

A docket lists, in chronological order, every document filed with the court in a case; this also serves as a timeline of events. A docket also includes the judge(s), parties, and lawyers in a case.

A docket number is the individual identifier that a court gives to a case. (Some courts use different terms, but the idea is the same.) Docket numbers usually include some or all of the following information, though it can appear in different orders or formats:

* The year the case was filed
* The type of case (civil, criminal, etc.)
* A unique serial number for the case
* Information on which courthouse or jurisdiction it was filed in

We collect complete docket numbers as they appear on case documents. We also collect the information it contains (year, case type, etc.) in separate fields.

Our system is designed around the federal courts' docketing conventions. The fields on our website correspond to the normal format for federal court docket number: 1:18-cv-528 (office:year-case type-filing number).

<details>

<summary>Example: a completely blank document</summary>

When accessing the \`api/v2p1/cases/case\_id/dockets/\` endpoint.

```javascript
{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": null,
      "case_id": null,
      "docket_entries": [
        {
          "row_number": null,
          "id": null,
          "entry_number": null,
          "date_filed": "",
          "attachments": [],
          "url": "",
          "recap_pdf_url": null,
          "pacer_doc_id": null,
          "description": ""
        }
      ],
      "docket_case_type": "",
      "docket_year": null,
      "docket_filing_number": null,
      "is_main_docket": false,
      "court": "",
      "state": "",
      "docket_office_number": "",
      "docket_number_manual": "",
      "scales_html": "",
      "recap_link": "",
      "is_active": false
    }
  ]
}

```

</details>

## id

(*number*)

The ID of the docket. This is different from the case ID and unique to the docket.

## case\_id

(*number*)

The ID of the case linked to the docket.

## docket\_number\_manual

(*string*)

The complete docket number, as it appears on case documents.

## docket\_office\_number

(*string*)

For federal courts, the courthouse or division where the case was filed. This will always be a one-digit number.

## docket\_year

(*number*)

The year the case was filed. We collect complete years (e.g. `2021`, not `21`).

## docket\_case\_type

(*string*)

Usually a 2-character code corresponding to a particular type of case (e.g. `"cv"` = civil; `"cr"` = criminal).

Not all dockets will have a case type code.

## docket\_filing\_number

(*number*)

The unique portion of a docket number. The filing number is generally unique within a given court.

## last\_updated

*(string)*

ISO 8601 date for when the docket was last updated in RECAP.

## court

(*string*)

The court where the docket exists. The options are the same as the `court` field for cases – see [Case Details](/api-reference-v2p1/objects/case/case-details#court).

## state

(*string*)

The state where the docket's court is located in.

## is\_main\_docket

(*boolean*)

If true, the docket is the main docket for the case. This is typically the trial docket where the case was first filed. On the Clearinghouse site, the main docket is displayed first.

## recap\_link

(*string*)

A link to a federal court docket in the RECAP Archive. The [RECAP Archive](https://www.courtlistener.com/recap) is a free, searchable collection of millions of federal court documents and dockets.

## docket\_entries

(*array\[object]*)

A list of docket entries. See [Docket Entry](/api-reference-v2p1/objects/docket-entry).

Note: Many dockets are available only as a PDF, rather than as a parsed array of docket entries. In those cases, the docket is saved as a document (see [Documents](/api-reference-v2p1/objects/case/documents)).

## scales\_html

(*string*)

A URL to an HTML file that is a saved version of the PACER HTML header. PACER, which stands for Public Access to Court Electronic Records, is the federal government's electronic system for providing access to federal court records.


# Docket Entry

A docket lists, in chronological order, every document filed with the court in a case. Each document and its accompanying information is a "docket entry." For more information about dockets, see [Docket](/api-reference-v2p1/objects/docket).

Dockets can be saved one of two ways in the Clearinghouse: (1) as parsed docket entries, or (2) as a PDF. This docket entry object is for parsed docket entries. For PDF dockets, the docket is saved as a document (see [Documents](/api-reference-v2p1/objects/case/documents)).

For federal docket entries from RECAP, some entries might be taken from PACER's RSS feed. These "RSS" entries have incomplete information.

## row\_number

(*number*)

The position of the docket entry within the docket, where the docket is a zero-indexed array of entries.

## entry\_number

(*string*)

For dockets that are numbered by the court, the number (as a string) assigned to the docket entry. Unlike [#row\_number](#row_number "mention"), these numbers start with '1'.

In federal court, this is known as an "ECF number," and every federal docket entry should have an ECF number. If the docket entry is part of a federal docket but `entry_number` is `null`, then the docket entry is likely an "RSS entry" (see above).

For state courts, states vary as to whether they assign numbers to docket entries, so whether `entry_number` is `null` depends on the state.

## date\_filed

(*string*)

The date of the docket entry, i.e. when the document was filed. This is in the format `"YYYY-MM-DDTHH:MM:ssTZ"`.

## description

(*string*)

The text that describes the document in a docket entry.

For RSS entries in federal dockets (see above), this will be an abbreviated version of the actual docket entry description (often just the type of document).

## attachments

(*array\[object]*)

Sometimes documents are attached to another document in PACER/RECAP. If so, the attached documents ("attachments") are gathered in an array associated with a docket entry.

Attachments have the following fields:

| Field              | Description                                                                                                                         |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| recap\_id          | The ID number given by RECAP.                                                                                                       |
| pacer\_url         | The URL to the document in PACER.                                                                                                   |
| description        | A short description of the document. Unlike a docket entry's overall description, an attachment description tends to be very short. |
| attachment\_number | Starting from 1, position of the attachment among the attachments for the docket entry.                                             |

## url

(*string*)

A URL to a page that embeds the document. For federal cases, this is a link to a [CourtListener (RECAP)](https://www.courtlistener.com) page. For state cases, this is a link to a [Docket Alarm](https://www.docketalarm.com) page.

For RSS entries in federal dockets (see above), this link is simply `"https://www.courtlistener.com"`.

## recap\_pdf\_url

(*string*)

A URL to the document (i.e. the PDF itself). If there is no such URL available or if this an RSS entry in a federal docket (see above), this field is `null`.

## pacer\_doc\_id

(*string*)

The ID of the document in PACER. PACER, which stands for Public Access to Court Electronic Records, is the federal government's electronic system for providing access to federal court records.

For RSS entries in federal dockets (see above), this field is `null`.

## id

(*number*)

The ID of the docket entry in the Clearinghouse.


# Document

A case will contain many more documents than are uploaded to the Clearinghouse. We generally add documents that provide additional information that help someone understand what is going on in the case, such as complaints, opinions, orders, and settlement agreements. We also add documents that we find particularly interesting, such as letters between lawyers about how to litigate the case. Particularly interesting documents that apply more broadly, such as memoranda explaining a complex litigation strategy involving multiple cases, are uploaded as resources (see [Resource](/api-reference-v2p1/objects/resource)).

Each document url endpoint returns a list of documents, where each document is a JSON dictionary containing `"next"`, `"previous"`, `"results"` and `"case_name"` values.

### case\_name

The top level `case_name` is the name of the case the documents belong to, as retrieved from the case itself.

This is not to be confused with the `case_name` inlined in document results, which is retrieved from the document itself (see [Document Details](/api-reference-v2p1/objects/document/document-details#case_name)).

### Example

<details>

<summary>Example: a completely blank document</summary>

When accessing the \`api/v2p1/cases/case\_id/documents/\` endpoint.

```javascript
{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": null,
      "title": "",
      "no_title": false,
      "description": "",
      "public_note": "",
      "date": "",
      "date_is_estimate": false,
      "date_not_available": false,
      "document_type": "",
      "document_type_other": null,
      "document_status": "",
      "case_name": "",
      "document_source": null,
      "order_type": null,
      "is_core_document": false,
      "court": "",
      "citation_paren": null,
      "citation_status": null,
      "cite_1_vol": null,
      "cite_1_reporter": null,
      "cite_1_page": null,
      "cite_2_vol": null,
      "cite_2_reporter": null,
      "cite_2_page": null,
      "cite_3_vol": null,
      "cite_3_reporter": null,
      "cite_3_page": null,
      "party_types": [],
      "per_curium": false,
      "ecf_number": "",
      "external_url": "",
      "clearinghouse_link": "",
      "file": null,
      "has_text": false,
      "text_url": ""
    }
  ],
  "case_name": ""
}

```

</details>

For more information:

| Field                 | Type           | Documentation (link)                                                                          |
| --------------------- | -------------- | --------------------------------------------------------------------------------------------- |
| date                  | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#date)                |
| date\_is\_estimate    | boolean        | [Document Details](/api-reference-v2p1/objects/document/document-details#date_is_estimate)    |
| date\_not\_available  | boolean        | [Document Details](/api-reference-v2p1/objects/document/document-details#date_not_available)  |
| description           | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#description)         |
| document\_source      | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#document_source)     |
| document\_type        | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#document_type)       |
| case\_name            | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#case_name)           |
| order\_type           | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#order_type)          |
| citation\_paren       | string         | [Citations](/api-reference-v2p1/objects/document/citations#citation_paren)                    |
| cite\_1\_page         | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_1_page)                       |
| cite\_1\_reporter     | string         | [Citations](/api-reference-v2p1/objects/document/citations#cite_1_reporter)                   |
| cite\_1\_vol          | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_1_vol)                        |
| cite\_2\_page         | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_2_page)                       |
| cite\_2\_reporter     | string         | [Citations](/api-reference-v2p1/objects/document/citations#cite_2_reporter)                   |
| cite\_2\_vol          | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_2_vol)                        |
| cite\_3\_page         | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_3_page)                       |
| cite\_3\_reporter     | string         | [Citations](/api-reference-v2p1/objects/document/citations#cite_3_reporter)                   |
| cite\_3\_vol          | number         | [Citations](/api-reference-v2p1/objects/document/citations#cite_3_vol)                        |
| citation\_status      | string         | [Citations](/api-reference-v2p1/objects/document/citations#citation_status)                   |
| court                 | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#court)               |
| no\_title             | boolean        | [Document Details](/api-reference-v2p1/objects/document/document-details#no_title)            |
| party\_types          | array\[string] | [Document Details](/api-reference-v2p1/objects/document/document-details#party_types)         |
| per\_curium           | boolean        | [Citations](/api-reference-v2p1/objects/document/citations#per_curium)                        |
| is\_core\_document    | boolean        | [Document Details](/api-reference-v2p1/objects/document/document-details#is_core_document)    |
| file                  | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#file)                |
| title                 | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#title)               |
| public\_note          | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#public_note)         |
| document\_type\_other | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#document_type_other) |
| external\_url         | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#external_url)        |
| ecf\_number           | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#ecf_number)          |
| clearinghouse\_link   | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#clearinghouse_link)  |
| id                    | number         | [Document Details](/api-reference-v2p1/objects/document/document-details#id)                  |
| document\_status      | string         | [Document Details](/api-reference-v2p1/objects/document/document-details#document_status)     |
| has\_text             | boolean        | [Document Details](/api-reference-v2p1/objects/document/document-details)                     |
| text\_url             | string         | [Document Details](/api-reference-v2p1/objects/document/document-details)                     |


# Document Details

## id

(*number*)

The document's ID. Each document's ID is unique.

## document\_status

(*string*)

Where the document is in the process of filling out the metadata. Note that this can differ from [Case Status](/api-reference-v2p1/objects/case/case-status#case_status), as the Clearinghouse has different processes for working on cases vs. documents.

| Value           | Description                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| Approved        | The document's metadata is complete.                                                                          |
| Coding Complete | The document's metadata is complete, but it is awaiting internal review.                                      |
| In Process      | The document has been added to the Clearinghouse, but work on the metadata has not started or is in progress. |

Like with [Case Status](/api-reference-v2p1/objects/case/case-status#case_status), the document status can be helpful in interpreting empty values for some fields.

## title

(*string*)

The name or title of a document, usually as it appears in the document itself. Most documents filed in court have formal names/titles (e.g. "Plaintiff's Motion for Summary Judgment"). For documents that don't, like letters, we use [#description](#description "mention").

## case\_name

*(string)*

The name of the case associated with the document, as retrieved from the document itself. For the name of the case as retrieved from the associated case itself, see the top level `"case_name"`  attribute&#x20;

## case\_id

*(integer)*

The id of the case this document belongs to.

## no\_title

(*boolean*)

If true, it indicates that the document doesn't have a title.

## description

(*string*)

A brief description of the document. We usually use this for documents that don't have formal titles (like letters).

## dockets

*(array)*

The dockets associated with this document. Each docket contains:

#### id

*(integer)*

The primary key of the docket.

#### name

*(string)*

Human-readable label built from the court and docket number\
(e.g. "Northern District of Georgia 1:09-cv-02674").

## ecf\_number

(*string*)

In federal court, documents filed in a case are assigned ECF numbers in the order they're filed. In the Clearinghouse, we use these numbers to line up documents with docket entries.

Sometimes one document is attached to another document in PACER/RECAP. The attached document will have a dash (e.g. `"15-2"`, where the document is the second attachment).

## date

(*string*)

The document's date in the format `"YYYY-MM-DD"`. This is usually when the document was filed in court, signed, or sent.

## date\_is\_estimate

(*boolean*)

If true, it indicates that date information is an estimate.

## date\_not\_available

(*boolean*)

If true, it indicates that we don't have any date information for a document.

## document\_type

(*string*)

What kind of thing the document is. We have a good number of options, some of which are more common than others. Most of the document types are specific kinds of court filings (e.g. `"Complaint"`), while others are more general (e.g. `"Correspondence"`).

| Document Type                                     | Description                                                                                                                                                                                                                                                                                           |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Complaint                                         | A document that contains the facts underlying the lawsuit, the plaintiff's legal claims, and what the plaintiff would like the court to do. A complaint often starts a case.                                                                                                                          |
| Opinion/Order                                     | A document where a judge or court make a decision in a case and (sometimes) explain their reasoning. These can be very short or very long, depending on the amount of legal reasoning.                                                                                                                |
| <p>Pleading/Motion</p><p>/Brief</p>               | This is a catch-all category for documents filed by lawyers in court.                                                                                                                                                                                                                                 |
| <p>Monitor/Expert/</p><p>Receiver Report</p>      | Monitors, experts, and receivers are all people with special expertise (e.g. doctors) who give the court their professional opinion. Often they create written reports on their findings.                                                                                                             |
| Settlement                                        | An agreement between the parties of the lawsuit to end the case. It might include a promise to pay money or to change actions.                                                                                                                                                                        |
| Docket                                            | A court's record of everything that happened in a case, usually organized by date.                                                                                                                                                                                                                    |
| Correspondence                                    | A letter NOT filed in court.                                                                                                                                                                                                                                                                          |
| Declaration/Affidavit                             | A legal document where somebody swears that facts are true, under penalty of perjury.                                                                                                                                                                                                                 |
| <p>Discovery/</p><p>FOIA Material</p>             | <p>Discovery: the evidence in a case, turned over as part of a lawsuit.<br>FOIA Material: government documents obtained through a Freedom of Information Act (or similar) request.</p>                                                                                                                |
| FOIA Request                                      | A request for government documents under the Freedom of Information Act.                                                                                                                                                                                                                              |
| Internal Memorandum                               | A memorandum or correspondence inside of an organization.                                                                                                                                                                                                                                             |
| Legislative Report                                | A report by a legislature.                                                                                                                                                                                                                                                                            |
| <p>Magistrate Report/</p><p>Recommendation</p>    | In the federal court system, magistrates are lower level judges who don't have the full powers of a federal judge. Sometimes they will resolve a legal question by writing a report and recommendation to a full federal judge, who can approve or reject it. These usually look a lot like opinions. |
| <p>Statute/</p><p>Ordinance/</p><p>Regulation</p> | A rule or law created by a legislature or state or federal agency.                                                                                                                                                                                                                                    |
| Executive Order                                   | A rule or order created by the president, a governor, or someone else in charge of a governmental entity, like a city or county.                                                                                                                                                                      |
| Transcripts                                       | A verbatim written record of a hearing or trial in court. These are in dialog format, like a screenplay.                                                                                                                                                                                              |
| Justification Memo                                | An internal memo by a DOJ attorney explaining why an entity should be investigated. This document type is just for U.S. Department of Justice Civil Rights Division cases.                                                                                                                            |
| Notice Letter                                     | A public letter from the DOJ to an entity letting them know they are the subject of an investigation. This document type is just for U.S. Department of Justice Civil Rights Division cases.                                                                                                          |
| Findings Memo                                     | A public memo from the DOJ explaining the findings of an investigation. This document type is just for U.S. Department of Justice Civil Rights Division cases.                                                                                                                                        |

## document\_type\_other

(*string*)

This field allows users to input a new, single use document type, if a document doesn't fit into any of the categories above. We don't use it very often.

## order\_type

(*number*)

This field indicates whether a document is a court order and, if so, what kind of court order.

In terms of kinds of orders, we're basically asking two questions:

1. Is the order a decree? We define decree to mean that the court is telling somebody outside of the lawsuit to do something.
2. Is the order on **consent** (the parties agreed to it) or was it **litigated** (the parties didn't agree and the court had to decide)?

Order type only matters for documents created by judges and settlements approved by judges. That means that for most document types, this value is `null`.

| Order Type       | Description                                                                                                           |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| null             | The document is not a court order.                                                                                    |
| Non-Decree       | A court order that does not tell somebody outside the lawsuit to do something.                                        |
| Litigated Decree | A court order that tells somebody outside the lawsuit to do something, where the parties didn't agree on the outcome. |
| Consent Decree   | A court order that tells somebody outside the lawsuit to do something, where the parties agreed on the outcome.       |

## document\_source

(*string*)

Where we originally sourced a document. There are lots of options, but some of the most common are:

| Document Source                 | Description                                                                                                      |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| PACER                           | The federal court system's online document filing website                                                        |
| RECAP                           | A website run by a non-profit organization which scrapes documents from PACER and makes them availalble for free |
| Westlaw, LexisNexis             | A commercial database of legal materials used by many lawyers                                                    |
| U.S. Department of Justice      | The federal agency responsible for enforcing many civil rights laws                                              |
| Papers of (various individuals) | Personal papers of an attorney, judge, or other civil rights figure that have been shared with the Clearinghouse |

<details>

<summary>Full list of document sources</summary>

* \---------
* ABA Supreme Court Briefs
* ACLU
* ACLU National Prison Project
* Bloomberg Law
* BPI (Gautreaux plaintiffs' counsel)
* BNA (Bureau of National Affairs)
* Cliff Fridkis Legal Files
* Defendant or Defendant's Counsel
* District Court
* Docket Alarm
* EEOC.gov
* EEOC Regional Office
* Foreign Intelligence Surveillance Court
* Google Scholar
* Helene V. Smookler Papers
* Impact Fund
* Justia
* Lainey Feingold website
* LexisNexis
* Library of Congress
* Los Angeles Unified School District Records
* Michelle Adams research file
* Monroe Edwin Price Papers
* Nat'l Archives (NARA)-details in other
* Non-PACER U.S. District Court Website
* Non-web U.S. District Court Clerk's Office
* Office of the Director of National Intelligence
* PACER \[Public Access to Court Electronic Records]
* Papers of Alexander (Sandy) Ross
* Papers of Beth Harris
* Papers of Brian Landsberg
* Papers of Bruce La Pierre
* Papers of Chad Quaintance
* Papers of Charles Cohler
* Papers of David Marlin
* Papers of David Norman
* Papers of Jack Ruzicho
* Papers of Joshua Dunn
* Papers of Margo Schlanger
* Papers of Marjorie Stockford (The Bellwomen)
* Papers of Melissa Marshall
* Papers of Owen Fiss
* Papers of Reuben Ortenberg
* Papers of Stephen Pollak
* Plaintiffs' counsel
* Prison Legal News
* Pro Publica
* Public.Resource.Org
* RECAP
* State Court Website
* Supreme Court website
* Univ. of Michigan Law Library
* U.S. Court of Appeals website
* U.S. Department of Justice Civil Rights Division, Disability Rights Section
* U.S. Department of Justice, Civil Rights Division, Employment Litigation Section
* U.S. Department of Justice, Civil Rights Division, Special Litigation Section
* U.S. Department of Justice, Civil Rights Division, Voting Rights Section
* U.S. Dep't of Justice, Civil Rights Division, Housing and Civil Enforcement
* U.S. DOJ, Civil Rights Division, Education Section
* Westlaw
* Papers of Harry A. Blackmun
* Papers of Thurgood Marshall

</details>

## party\_types

(*array\[string]*)

The types of parties or entities that filed or created a document. More than one can be selected. The options are:

| Option                  | Description                                                                                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Plaintiff               | The person or entity who files a lawsuit.                                                                                                 |
| Administrative tribunal | A government office or agency, other than a court, that resolves disputes.                                                                |
| Amicus Curiae           | Latin for "friend of the court." Someone who isn't a part of a lawsuit, but gives the judge advice about how to decide a case.            |
| Mediator                | A person (other than the judge) who tries to help the parties to a lawsuit negotiate a compromise agreement.                              |
| Defendant               | The person or entity who a lawsuit is filed against                                                                                       |
| Court                   | The judge.                                                                                                                                |
| Defendant-Intervenor    | A person or entity who joins a case filed by someone else as a defendant.                                                                 |
| Expert                  | A person with special expertise (like a doctor or scientist) who is hired by the parties or the court to give their opinion in a lawsuit. |
| Monitor/Master          | A person hired by the court to determine whether an institution or entity is complying with the terms of a settlement or court order.     |
| Plaintiff-Intervenor    | A person or entity who joins a case filed by someone else as a plaintiff.                                                                 |
| Receiver                | A person who is placed in control of an institution or entity by a court.                                                                 |

## court

(*string*)

The court where the document was filed. The options are the same as the `court` field for cases -- see [Case Details](/api-reference-v2p1/objects/case/case-details#court).

## is\_core\_document

(*boolean*)

Whether the document is a central document to the case. By default, all documents are core documents; we use this only to tidy up cases with lots of documents.

On the Clearinghouse site, this controls whether the document is immediately visible. If `is_core_document` is false, then a user must uncheck the "show only core documents" box to see the document on the Clearinghouse site.

## public\_note

(*string*)

This field allows us to add publicly visible text to a document entry.

## external\_url

(*string*)

A link to the document at another place on the Internet.

## clearinghouse\_link

(*string*)

URL to the clearinghouse.net page for the document.

## file

(*string*)

URL to the PDF file for the document.

## has\_text

(*boolean*)

If true, it indicates that the document's text was generated via optical character recognition (OCR) or manual input. See [Text URL](/api-reference-v2p1/objects/document/text-url) for more information.

## text\_url

(*string*)

URL to the api page that contains the document's text. See [Text URL](/api-reference-v2p1/objects/document/text-url) for more information.


# Citations

These fields allow us to add legal citation information to documents, particularly judicial opinions.

The basic format of a case citation is: (volume) (reporter) (page number) – e.g. 372 U.S. 335. A reporter is a publication containing judicial opinions, limited to a set of courts, and it organizes the opinions chronologically. The volume number indicates which volume of the reporter, and the page number indicates the starting page of the opinion. A reporters used to be a series of books – now everything is online, but the old system remains. Periodically, we add new reporters to our system.

Individual opinions can have multiple citations in different reporters, some of which lawyers will prefer to cite over others. We often collect multiple citations for a given opinion, with Citation 1 being the typically most preferred and Citation 3 being the least.

Note: Not all of our reporter abbreviations match Bluebook abbreviations.

## citation\_status

(*string*)

The status of the citation information. There are a several possible values for this field:

| Value                                            | Description                                                                                                                                                 |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| null                                             | This field has not been set yet. This is likely because the document's metadata is not yet complete.                                                        |
| Don't know                                       | We don't know if this document has a citation.                                                                                                              |
| No citation available                            | There is no citation for this document, but it is an opinion or order (i.e. a type of document that could have a citation.                                  |
| Not applicable                                   | The document is not the type of document that can have a citation (i.e. it is not an opinion or order).                                                     |
| Not checked yet                                  | We have not checked for a citation yet.                                                                                                                     |
| Official citation found/coded                    | We found an official citation (i.e. not Westlaw or Lexis) and have updated the appropriate fields.                                                          |
| S.Ct. - check later for U.S.                     | The document has a citation for the Supreme Court Reporter (S. Ct.) but was too recent to have a citation for the U.S. Reports (U.S.) when we last checked. |
| WL/LEXIS cite: Check later for official citation | The document has a Westlaw or Lexis citation but was too recent to have an official citation when we last checked.                                          |
| WL/LEXIS only: No official citation available    | The document has a Westlaw or Lexis citation but does not have an official citation.                                                                        |

For more information on the various reporters, see below.

## cite\_1\_vol

(*number*)

The volume number for Citation 1. If there is no citation for Citation 1, this field is `null`.

## cite\_1\_reporter

(*string*)

The reporter for Citation 1. If there is no citation for Citation 1, this field is `null`.

Citation 1 is for our preferred reporters, which include several types of reporters:

| Reporter              | Example(s)                                  | Description                                                                                                                                               |
| --------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| U.S. Reports          | U.S.                                        | Reporter for the U.S. Supreme Court                                                                                                                       |
| Federal Reporter      | <ul><li>F.</li><li>F.2d</li></ul>           | Reporter for the federal circuit courts                                                                                                                   |
| Federal Supplement    | <ul><li>F.Supp.</li><li>F.Supp.2d</li></ul> | Reporter for the federal district courts, U.S. Court of International Trade, U.S. Court of Federal Claims, and Judicial Panel on Multidistrict Litigation |
| Federal Appendix      | Fed.Appx.                                   | Reporter for circuit opinions that are "unpublished"                                                                                                      |
| Regional Reporters    | <ul><li>N.W.</li><li>A.</li></ul>           | West's reporters for state courts                                                                                                                         |
| State Court Reporters | <ul><li>Mich.</li><li>Mass</li></ul>        | Individual states' reporters for their courts                                                                                                             |

<details>

<summary>Full list of reporters for Citation 1</summary>

* A.2d
* A.3d
* A.D.2d
* A.D.3d
* Ark.
* B.R.
* Cal.App. 3d
* Cal.App.4th
* Cal.App. 5th
* Cal.Rptr.
* Cal.Rptr.2d
* F.2d
* F.3d
* F.4th
* Fed.Appx.
* Fed.R.Serv.3d
* F.R.D.
* F.Supp.
* F.Supp.2d
* F.Supp.3d
* Mass.
* Mass. L. Rptr.
* Misc.2d
* Misc.3d
* N.E.2d
* N.E.3d
* N.W\.2d
* N.Y.S.2d
* P.2d
* P.3d
* S.E.2d
* So.2d
* So.3d
* S.W\.2d
* S.W\.3d
* U.S.
* Vet.App.
* Wash. App.
* W\.Va.
* Mich.

</details>

## cite\_1\_page

(*number*)

The page number for Citation 1. If there is no citation for Citation 1, this field is `null`.

## cite\_2\_vol

(*number*)

The volume number for Citation 2. For Westlaw citations, the volume is the year of the opinion. If there is no citation for Citation 2, this field is `null`.

## cite\_2\_reporter

(*string*)

The reporter for Citation 2. If there is no citation for Citation 2, this field is `null`.

These are not the most preferred reporters, but many lawyers prefer them to those in Citation 3 (see [#cite\_3\_reporter](#cite_3_reporter "mention")). There are only two options for Citation 2:

| Value | Description                                                                                         |
| ----- | --------------------------------------------------------------------------------------------------- |
| S.Ct. | Supreme Court Reporter. Typically publishes recent opinions faster than the U.S. Reports.           |
| WL    | Westlaw. A commercial electronic database that contains many judicial opinions, among other things. |

## cite\_2\_page

(*number*)

The page number for Citation 2. If there is no citation for Citation 2, this field is `null`.

## cite\_3\_vol

(*number*)

The volume number for Citation 3. For Lexis citations, the volume is the year of the opinion. If there is no citation for Citation 3, this field is `null`.

## cite\_3\_reporter

(*string*)

The reporter for Citation 3. If there is no citation for Citation 3, this field is `null`.

These are the reporters we prefer not to use (and don't often collect). There are two types of reporters for Citation 3:

| Reporter                                     | Example(s)                                             | Description                                                                                            |
| -------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
| U.S. Supreme Court Reports, Lawyers' Edition | L.Ed.                                                  | Reporter for the U.S. Supreme Court                                                                    |
| Lexis                                        | <ul><li>U.S.Dist.LEXIS</li><li>U.S.App.LEXIS</li></ul> | LexisNexis. A commercial electronic database that contains many judicial opinions, among other things. |

<details>

<summary>Full list of reporters for Citation 3</summary>

* Ala.App.LEXIS
* Ala.Civ.App.LEXIS
* Ala.LEXIS
* Alas.LEXIS
* Ariz.App.LEXIS
* Ariz.LEXIS
* Ark.App.LEXIS
* Ark.LEXIS
* Cal.App.LEXIS
* Cal.App.Unpub.LEXIS
* Cal.LEXIS
* Colo.App.LEXIS
* Colo.LEXIS
* Conn.App.LEXIS
* Conn.Cir.LEXIS
* Conn.LEXIS
* Conn.Super.LEXIS
* D.C.App.LEXIS
* D.C.Super.LEXIS
* Del.Ch.LEXIS
* Del.LEXIS
* Del.Super.LEXIS
* Fla.App.LEXIS
* Fla.LEXIS
* Ga.App.LEXIS
* Ga.LEXIS
* GuamLEXIS
* Haw\.App.LEXIS
* Haw\.LEXIS
* Ida.App.LEXIS
* Ida.LEXIS
* Ill.App.LEXIS
* Ill.LEXIS
* Ind.App.LEXIS
* Ind.LEXIS
* IowaApp.LEXIS
* IowaSup.LEXIS
* Kan.App.LEXIS
* Kan.LEXIS
* Ky.App.LEXIS
* Ky.LEXIS
* La.App.LEXIS
* La.LEXIS
* L.Ed.
* L.Ed.2d
* Mass.App.Div.LEXIS
* Mass.App.LEXIS
* Mass.LEXIS
* Mass.Super.LEXIS
* Md.App.LEXIS
* Md.LEXIS
* Me.LEXIS
* Me.Super.LEXIS
* Mich.App.LEXIS
* Mich.LEXIS
* Minn.App.LEXIS
* Minn.LEXIS
* Miss.App.LEXIS
* Miss.LEXIS
* Mo.App.LEXIS
* Mo.LEXIS
* Mont.Dist.LEXIS
* Mont.LEXIS
* N.C.App.LEXIS
* N.C.LEXIS
* N.D.App.LEXIS
* N.D.LEXIS
* Neb.App.LEXIS
* Neb.LEXIS
* Nev.LEXIS
* N.H.LEXIS
* N.J.LEXIS
* N.J.Sup.Ct.LEXIS
* N.J.Super.LEXIS
* N.M.App.LEXIS
* N.Mar.I.LEXIS
* N.M.LEXIS
* N.Y.App.Div.LEXIS
* N.Y.LEXIS
* N.Y.Misc.LEXIS
* OhioApp.LEXIS
* OhioLEXIS
* Okla.Civ.App.LEXIS
* Okla.LEXIS
* Pa.LEXIS
* Pa.Super.LEXIS
* PRApp.LEXIS
* PRSup.LEXIS
* R.I.LEXIS
* R.I.Super.LEXIS
* S.C.App.LEXIS
* S.C.LEXIS
* S.D.LEXIS
* Tenn.App.LEXIS
* Tenn.LEXIS
* Tex.App.LEXIS
* Tex.LEXIS
* U.S.App.LEXIS
* U.S.Dist.LEXIS
* UtahApp.LEXIS
* UtahLEXIS
* Va.App.LEXIS
* Va.LEXIS
* V.I.LEXIS
* Vt.LEXIS
* Wash.App.LEXIS
* Wash.LEXIS
* Wisc.App.LEXIS
* Wisc.LEXIS
* W\.Va.LEXIS
* Wyo.LEXIS

</details>

## cite\_3\_page

(*number*)

The page number for Citation 3. If there is no citation for Citation 3, this field is `null`.

## per\_curiam

(*boolean*)

If the opinion was issued *per curiam*, which is Latin for "for the court." This means that the opinion wasn't authored by an individual judge.

## citation\_paren

(*string*)

Information following a citation giving the reader extra information about its context. We rarely use them, so `citation_paren` is often `null`.

Here are the other options:

| Value                                        | Description                                                                                                                                                                                                                               |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| aff'd by an equally divided court            | The opinion was affirmed by the the U.S. Supreme Court through a tie vote without an opinion on the substance of the case.                                                                                                                |
| aff'd per curiam                             | The opinion was affirmed by a *per curiam* opinion, where the opinion wasn't authored by an individual judge.                                                                                                                             |
| amicus motion denied                         | A motion to file an amicus brief was denied. An *amicus curiae*, Latin for "friend of the court," is a person or entity who is not a party to the case but asks the court for permission to advise the court on some aspect of the case.  |
| amicus motion granted                        | A motion to file an amicus brief was granted. An *amicus curiae*, Latin for "friend of the court," is a person or entity who is not a party to the case but asks the court for permission to advise the court on some aspect of the case. |
| appeal dismissed                             | The appeal of the decision was dismissed.                                                                                                                                                                                                 |
| cert. denied                                 | A higher court (typically the U.S. Supreme Court) rejected a request to review the lower court decision, known as a petition for writ of certiorari.                                                                                      |
| cert. dismissed                              | A higher court (typically the U.S. Supreme Court) granted a request to review the lower court decision (a petition for writ of certiorari) but then later decided to reverse its decision – dismissing the grant of certiorari.           |
| cert. granted                                | A higher court (typically the U.S. Supreme Court) granted a request to review the lower court decision, known as a petition for writ of certiorari.                                                                                       |
| consolidation denied                         | A request to consolidate similar cases was denied.                                                                                                                                                                                        |
| counsel appointment request granted          | A request to appoint counsel was granted.                                                                                                                                                                                                 |
| en banc                                      | The case was heard by all of the judges of a particular court (as opposed to a panel with only some of the judges). En banc is French for "on the bench."                                                                                 |
| inviting Solicitor General to file brief     | The U.S. Supreme Court invited the solicitor general to file a brief expressing the views of the U.S. in a case where a party petitioned for certiorari – a procedure known as "Call for the Views of the Solicitor General" (CVSG).      |
| joint appendix -- granting OR denying motion | Relevant legal documents submitted to support a petition for writ of certiorari.                                                                                                                                                          |
| mandamus denied                              | The court denied a writ of mandamus, which is a court order (usually from an appellate court) requiring a government official or entity to do their public duty (that they have neglected or refused to do).                              |
| merits opinion                               | The opinion analyzes the substantive law of the case, rather than addressing only procedural matters.                                                                                                                                     |
| motion to dismiss cert. denied               | A higher court (typically the U.S. Supreme Court) denied a request to reverse a previously granted a writ of certiorari. (See "cert. dismissed" above.)                                                                                   |
| opinion respecting the denial of cert.       | An opinion denying a writ of certiorari where the justice felt so strongly that they chose to write a separate opinion.                                                                                                                   |
| oral argument motion granted OR denied       | An oral argument motion was granted or denied. Oral argument is when lawyers speak in front of the judge(s), with the judge(s) interrupting to ask questions.                                                                             |
| prob. juris. decision deferred               | When appealing a decision, the question of whether the higher court (typically the U.S. Supreme Court) has probable jurisdiction over the appeal has been postponed to the hearing on the merits.                                         |
| prob. juris. noted                           | When appealing a decision, the higher court (typically the U.S. Supreme Court) has noted that it has probable jurisdiction over the appeal.                                                                                               |
| reh'g denied                                 | A request for a rehearing of the case was denied.                                                                                                                                                                                         |
| reh'g granted                                | A request for a rehearing of the case was granted.                                                                                                                                                                                        |
| requesting briefing                          | The court requested that the parties submit written arguments ("briefs") to the court. This practice is known as "briefing."                                                                                                              |
| rev'd per curiam                             | The opinion was reversed by a *per curiam* opinion, where the opinion wasn't authored by an individual judge.                                                                                                                             |
| stay denied                                  | A request for a pause ("stay") of enforcement of the judgment was denied.                                                                                                                                                                 |
| stay granted                                 | A request for a pause ("stay") of enforcement of the judgment was granted.                                                                                                                                                                |
| stay vacated                                 | The court set aside ("vacated") a pause ("stay") of enforcement of the judgment.                                                                                                                                                          |
| stay vacatur denied                          | A request to remove a stay of enforcement of the judgment was denied. ("Vacatur" is Latin for "it is vacated.")                                                                                                                           |
| summarily affirmed (without opinion)         | The opinion was affirmed by a higher court without the higher court hearing further argument (and without issuing an opinion).                                                                                                            |
| summarily reversed (without opinion)         | The opinion was reversed by a higher court without the higher court hearing further argument (and without issuing an opinion).                                                                                                            |
| table                                        | The decision was a very short order summarily affirming a lower court opinion published in a table in a reporter. Federal courts of appeals no longer do this.                                                                            |
| vacated and remanded                         | On appeal, a higher court set aside ("vacated") the decision and asked the lower court to redo their decision in light of some guidance provided by the higher court ("remanded" the decision).                                           |
| vacated as moot                              | The decision was set aside because the dispute had been resolved in some other way. When a dispute is no longer "live," it becomes "moot."                                                                                                |


# Text URL

The documents endpoint returns a paginated list of document objects under `results`. Each document may include two fields related to extracted text:

* **`has_text`**: `true` if this document has extracted text available. The text was **manually transcribed** or produced via **OCR during upload**.
* **`text_url`**: the endpoint where you can fetch that extracted text.

**Example**

A document record may include:

* `has_text: true`
* `text_url: "https://www.clearinghouse.net/api/v2p1/documents/15745/text/"`

Requesting `text_url` returns:

```json
{
  "id": 15745,
  "text": "..."
}
```

where `text` contains the extracted document text (OCR/transcription).


# Resource

Resources are websites, articles, or other sources that we think are helpful for understanding the case. This can include in-depth case studies, law review articles discussing the case, or websites that post litigation documents beyond what we save in the Clearinghouse.

Each resource url endpoint returns a list of resources, where each resource is a JSON dictionary.

<details>

<summary>Example: a completely blank resource</summary>

When accessing the \`api/v2p1/cases/case\_id/resources/\` endpoint.

```javascript
{
  "next": null,
  "previous": null,
  "results": [
    {
      "file": null,
      "title": "",
      "author_role": null,
      "abstract": "",
      "author": "",
      "institution": "",
      "citation": "",
      "external_url": "",
      "display_date": "",
      "resource_types": [],
      "cases": [],
      "case_types": [],
      "date": null,
      "causes": [],
      "issues": [],
      "special_collections": [],
      "attorney_orgs": [],
      "source": "",
      "status": ""
    }
  ]
}

```

</details>

For more information:

| Field                | Type           | Documentation (link)                                                                     |
| -------------------- | -------------- | ---------------------------------------------------------------------------------------- |
| file                 | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#file)           |
| title                | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#title)          |
| author\_role         | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#author_role)    |
| abstract             | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#abstract)       |
| author               | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#author)         |
| institution          | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#institution)    |
| citation             | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#citation)       |
| external\_url        | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#external_url)   |
| display\_date        | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#display_date)   |
| resource\_types      | array\[string] | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#resource_types) |
| cases                | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#cases)                |
| case\_types          | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#case_types)           |
| date                 | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#date)           |
| causes               | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#causes)               |
| issues               | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#issues)               |
| special\_collections | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#special_collections)  |
| attorney\_orgs       | array\[string] | [Related Items](/api-reference-v2p1/objects/resource/related-items#attorney_orgs)        |
| source               | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details#source)         |
| status               | string         | [Resource Details](/api-reference-v2p1/objects/resource/resource-details)                |


# Resource Details

## file

(*string*)

URL to the PDF file of the resource (if applicable). If the resource is a webpage, then `file` is `null`.

## resource\_types

(*array\[string]*)

We collect a several kinds of resources, which are usually different kinds of things.

| Option                                    | Description                                                                                                                                                                      |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Clearinghouse Links to External Resources | Links to other websites with information relevant to a case. For example, an ACLU webpage describing a case it litigated or an Oyez entry for a case heard by the Supreme Court. |
| Articles about the Clearinghouse          | Articles or webpages, including news coverage, about the Clearinghouse or describing Clearinghouse projects.                                                                     |
| Articles that use the Clearinghouse       | Law review or other periodicals that cite entries in the Clearinghouse.                                                                                                          |
| Case Studies                              | A law review article, book, or other resource that discusses a case in the Clearinghouse.                                                                                        |
| Clearinghouse Report                      | A white paper or report produced by the Clearinghouse.                                                                                                                           |

## title

(*string*)

The title of the resource, usually as it appears in the resource itself.

## author

(*string*)

The full name of the author or authors, if they are individuals.

## institution

(*string*)

The author of the resource, if it's an institutional author. The institutional affiliation of an author, if the author is an individual.

## author\_role

(*string*)

Identifies whether a resources was created by a student or faculty member. Used only for pieces published in law reviews or other periodicals. The options are:

| Author Role | Description                                         |
| ----------- | --------------------------------------------------- |
| N/A         | Resource is not a law review article or periodical. |
| Faculty     | Written by a professor.                             |
| Law Student | Written by a law student.                           |
| Student     | Written by a non-law student.                       |

## abstract

(*string*)

A brief description of the resource. For law review pieces and other periodicals, we copy and paste the abstract into this field. For other kinds of resources we usually copy a representative paragraph or compose a quick description of the resource.

## date

(*string*)

The date a resource was created or published. The format of this string is `"YYYY-MM-DDThh:mm:ssTZ"`. The time zone (`TZ`) will be either `-5:00` for Eastern Standard Time or `-4:00` for Eastern Daylight Time.

## display\_date

(*string*)

A written version of the date the resource was published or created. This field allows us to differentiate different issues of periodicals (e.g. `"Fall 2021"`, `"May 1996"`).

## citation

(*string*)

The citation for a resource. Usually used for law review articles or other periodicals.

## external\_url

(*string*)

A link to the resource elsewhere on the web.

## source

(*string*)

For articles in law reviews or other periodicals, this field is the name of the publication.

For websites, this field is the root of website.

## status

(*string*)

The status of the resource.

| Option   |
| -------- |
| Inactive |
| Complete |
| Approved |


# Related Items

Resources can be marked as related to other things in the Clearinghouse.

## cases

(*array\[string]*)

The cases that are related to the resource.

If the resource also has related case types, causes of action, issues, special collections, or attorney organizations, individual cases that all under those related items will *not* be part of `cases`.

## case\_types

(*array\[string]*)

The case types that are related to the resource. For a full list of case types, see [#case\_types](/api-reference-v2p1/objects/case/case-details#case_types).

## causes

(*array\[string]*)

The causes of action that are related to the resource. For a full list of causes of action, see [#causes](/api-reference-v2p1/objects/case/causes-of-action#causes).

## issues

(*array\[string]*)

The issues that are related to the resource. For a full list of issues, see [#issues](/api-reference-v2p1/objects/case/issues#issues).

## special\_collections

(*array\[string]*)

The special collections that are related to the resource. For a full list of special collections, see [#special\_collections](/api-reference-v2p1/objects/case/case-details#special_collections).

## attorney\_orgs

(*array\[string]*)

The attorney organizations that are related to the resource. For a full list of attorney organizations, see [#attorney\_orgs](/api-reference-v2p1/objects/case/parties#attorney_orgs).


# API Reference V2.0 (Legacy)

Welcome to **API v2.0**! This version introduces several improvements designed to make the API faster and more scalable.

To learn more about it, see [New Features](/api-reference-v2/new-features).


# New Features

CRCLA V2.0 introduces several improvements designed to make the API faster and more scalable.

## Key Highlights

* **Improved Performance:** Endpoints now return lighter responses by moving large related datasets to paginated URLs.
* **Versioning:** All v2.0 endpoints are available under the `/api/v2/` namespace.
* **Hyperlinked Relationships:** Instead of embedding large nested arrays, related records are now referenced by hyperlinks you can query separately.

***

## Changes to Related Endpoints

To speed up queries and improve response times, three fields that previously returned all records inline have been updated to provide paginated URLs instead.

| Field                | Type         | Documentation Link                                                                         |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------ |
| `case_documents_url` | string (URL) | [#case\_documents\_url](/api-reference-v2/objects/case/pagination-urls#case_documents_url) |
| `case_dockets_url`   | string (URL) | [#case\_dockets\_url](/api-reference-v2/objects/case/pagination-urls#case_dockets_url)     |
| `case_resources_url` | string (URL) | [#case\_resources\_url](/api-reference-v2/objects/case/pagination-urls#case_resources_url) |

These fields now return a link you can follow to retrieve related records in a paginated format.

To learn more about pagination behavior, see [Pagination](/api-reference-v2/new-features/pagination).

### Removed Fields

As part of this change, a few fields that previously contained large serialized data has been removed and replaced by the URL fields listed above:

* `case_documents`
* `case_dockets`
* `case_resources`

If your integration relied on these fields, you will now need to follow the corresponding URL to retrieve related records.

***

### Query Related Records Directly

In addition to using the `*_url` fields returned in each `Case` object, you can also **query related records directly by filtering on the `case` parameter**.

This allows you to retrieve all related resources for a case without relying only on hyperlinks.

#### Examples

* Retrieve all resources for a specific case: `/api/v2/resources/?case=15150`
* Retrieve all documents for a specific case: `/api/v2/documents/?case=15150`
* Retrieve all dockets for a specific case: `/api/v2/dockets/?case=15150`

To learn more about query behavior, see [Query Behavior](/api-reference-v2/new-features/query-behavior).


# Pagination

All API v2.0 list endpoints return paginated responses by default. This improves performance and ensures that large datasets can be retrieved efficiently.

***

## How Pagination Works

Every list endpoint responds with a standardized JSON structure that includes:

* `count`: the total number of matching records
* `next`: the URL to fetch the next page (or `null` if there is no next page)
* `previous`: the URL to fetch the previous page (or `null` if you are on the first page)
* `results`: an array containing the records in the current page

***

## Example Paginated Response of a Case Query:

```json
{
  "count": 473,
  "next": "https://clearinghouse.net/api/v2/case/?case_type=5039&page=3",
  "previous": "https://clearinghouse.net/api/v2/case/?case_type=5039&page=1",
  "results": [
    {
      "id": 15150,
      "name": "Pottinger v. City of Miami",
      "case_documents_url": "https://clearinghouse.net/api/v2/documents/?case=15150", // URL to retrieve documents related to this case.
      "case_dockets_url": "https://clearinghouse.net/api/v2/dockets/?case=15150", // URL to retrieve dockets related to this case.
      "case_resources_url": "https://clearinghouse.net/api/v2/resources/?case=15150", // URL to retrieve resources related to this case.
      "...": "..."
    },
    ...
    // More cases here
  ]
}

```


# Query Behavior

API v2.0 supports flexible query parameters so you can filter and retrieve exactly the records you need.

## Filtering

You can retrieve resources, documents, and dockets associated with a specific case by including the case parameter in your request. For example:

* **Filter cases by type:** `/api/v2/case/?case_type=5039`
* **Filter resources associated with a specific case:** `/api/v2/resources/?case=15150`

**Note: You cannot filter records without specifying a case. For example:** `/api/v2/documents/?document_status=Approved` Will return

```json
{"detail": "The 'case' query parameter is required."}
```

When accessing the URL endpoints for resources, documents, or dockets, please refer to these pages for detailed response examples:

* [Documents](/api-reference-v2/objects/document)
* [Resources](/api-reference-v2/objects/resource)
* [Dockets](/api-reference-v2/objects/docket)


# Endpoints




---

[Next Page](/llms-full.txt/1)