Skip to content
GET /v1/cases

Browse cases by term

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/oyez-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/oyez-api/v1/cases" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/oyez-api/v1/cases", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/oyez-api/v1/cases");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/oyez-api/v1/cases",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "term": "2008",
        "cases": [
            {
                "id": 55535,
                "href": "https://api.oyez.org/cases/2008/07-581",
                "name": "14 Penn Plaza LLC v. Pyett",
                "term": "2008",
                "decided": true,
                "justia_url": "https://supreme.justia.com/cases/federal/us/556/247/",
                "description": "A case in which the Court held that arbitration clauses in employment contracts are enforceable as a matter of federal law.",
                "docket_number": "07-581"
            },
            {
                "id": 55536,
                "href": "https://api.oyez.org/cases/2008/07-582",
                "name": "FCC v. Fox Television Stations, Inc.",
                "term": "2008",
                "decided": true,
                "justia_url": null,
                "description": "A case in which the Court held that the FCC's imposition of liability on Fox Television Stations for fleeting expletives was not \"arbitrary and capricious\" under the Administrative Procedure Act, even though the FCC previously accepted similar expletives.",
                "docket_number": "07-582"
            },
            {
                "id": 55537,
                "href": "https://api.oyez.org/cases/2008/07-751",
                "name": "Pearson, et al. v. Callahan",
                "term": "2008",
                "decided": true,
                "justia_url": null,
                "description": "A case in which the Court overturned its previous decision in Saucier v. Katz, which prescribed a rigid test for government qualified immunity claims, and held that inquiries should be at the discretion of the lower courts.",
                "docket_number": "07-751"
            },
            {
                "id": 55538,
                "href": "https://api.oyez.org/cases/2008/07-1090",
                "name": "Republic of Iraq v. Beaty",
                "term": "2008",
                "decided": true,
                "justia_url": null,
                "description": null,
                "docket_number": "07-1090"
            },
            {
                "id": 55539,
                "href": "https://api.oyez.org/cases/2008/07-1239",
                "name": "Winter v. Natural Resources Defense Council, Inc.",
                "term": "2008",
                "decided": true,
                "justia_url": null,
                "description": "A case in which the Court held that the standard for properly granting a preliminary injunction is not based on the \"possibility\" of irreparable harm to marine life, but rather that \"irreparable injury is likely\" in the absence of such an injunction.",
                "docket_number": "07-1239"
            },
            {
                "id": 55540,
                "href": "https://api.oyez.org/cases/2008/08-305",
                "name": "Forest Grove School District v. T.A.",
                "term": "2008",
          
…