# Case 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                                                          |
| ------------------------------------------- | ------- | -------------------------------------------------------------------- |
| state\_id<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 [#court](https://api.clearinghouse.net/objects/case/case-details#court "mention").

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