# Cause of Action

## Filter by cause of action (integer).

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

#### Query Parameters

| Name                                                    | Type    | Description                                                           |
| ------------------------------------------------------- | ------- | --------------------------------------------------------------------- |
| cause\_of\_action\_id<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.md#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 %}


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://api.clearinghouse.net/api-reference-v2p1/endpoints/case-details/cause-of-action.md?ask=<question>
```

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

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