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

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