# Oyez API: List term cases

> Lists Oyez Supreme Court cases for a term, sorted by argument date then name. Decision dates and vote splits are blank where Oyez does not provide them.

Unofficial. Not affiliated with or endorsed by Oyez.

- Page: https://fous.com/methods/oyez.org/list-term-cases
- Method: `oyez.org/list_term_cases`, version 1
- Website: oyez.org
- Returns: case name, docket number, argued and decided dates, status, vote split, question, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `term` | integer | yes | `2023` | Year the Supreme Court term began, for example 2023 for the October 2023 term. |
| `status` | string | no | `"all"` | Choose all, decided, argued_not_decided, or not_yet_argued; for example, decided. One of "all", "decided", "argued_not_decided", "not_yet_argued". Default "all". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "term": 2023,
  "status": "all"
}
```

Its output:

```json
{
  "cases": [
    {
      "link": "https://www.oyez.org/cases/2023/22-340",
      "status": "Decided",
      "question": "Must a defendant show he does not meet any of the criteria listed in 18 U.S.C. § 3553(f) to qualify for a sentence lower than the statutory minimum?",
      "case_name": "Pulsifer v. United States",
      "vote_split": "6-3",
      "date_argued": "2023-10-02",
      "date_decided": "2024-03-15",
      "docket_number": "22-340"
    },
    {
      "link": "https://www.oyez.org/cases/2023/22-448",
      "status": "Decided",
      "question": "Does the funding scheme for the Consumer Financial Protection Bureau, which receives funding directly from the Federal Reserve, violate the Appropriations Clause of the Constitution?",
      "case_name": "Consumer Financial Protection Bureau v. Community Financial Services Association of America",
      "vote_split": "7-2",
      "date_argued": "2023-10-03",
      "date_decided": "2024-05-16",
      "docket_number": "22-448"
    },
    {
      "link": "https://www.oyez.org/cases/2023/22-429",
      "status": "Decided",
      "question": "Does an ADA “tester” have Article III standing to challenge a hotel’s failure to provide disability accessibility information on its website, even if she has no plans to visit the hotel?",
      "case_name": "Acheson Hotels, LLC v. Laufer",
      "vote_split": "9-0",
      "date_argued": "2023-10-04",
      "date_decided": "2023-12-05",
      "docket_number": "22-429"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"oyez.org/list_term_cases","input":{"term":2023,"status":"all"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me every Supreme Court case from the October 2021 term with argument dates, vote splits, and the question presented
- Which cases from the 2024 Supreme Court term have been argued but still don't have a decision?
- Pull the Oyez list of decided cases for the 2019 term, including docket numbers and how the justices split
- I need the cases on the 2025 SCOTUS docket that haven't been heard at oral argument yet
- Using oyez.org, list all cases from the term that began in October 2016, ordered by when they were argued

## Input schema

```json
{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "integer",
      "examples": [
        2023
      ],
      "description": "Year the Supreme Court term began, for example 2023 for the October 2023 term."
    },
    "status": {
      "enum": [
        "all",
        "decided",
        "argued_not_decided",
        "not_yet_argued"
      ],
      "type": "string",
      "default": "all",
      "description": "Choose all, decided, argued_not_decided, or not_yet_argued; for example, decided."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "cases"
  ],
  "properties": {
    "cases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "case_name",
          "docket_number",
          "date_argued",
          "date_decided",
          "status",
          "vote_split",
          "question",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "format": "uri"
          },
          "status": {
            "type": "string"
          },
          "question": {
            "type": [
              "string",
              "null"
            ]
          },
          "case_name": {
            "type": "string"
          },
          "vote_split": {
            "type": [
              "string",
              "null"
            ],
            "description": "Majority-minority split, when available."
          },
          "date_argued": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "date_decided": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "docket_number": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Supreme Court cases for the selected term and status."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Oyez API: Get Supreme Court case](https://fous.com/methods/oyez.org/get-supreme-court-case.md): Finds an Oyez Supreme Court case by name or case link and returns its summary, decision, justice votes and argument audio links.
- [CourtListener API: Search case law](https://fous.com/methods/courtlistener.com/search-case-law.md): Searches CourtListener US court opinions by keywords or case name, with optional court, decision dates and sorting.
- [CourtListener API: Search federal dockets by party](https://fous.com/methods/courtlistener.com/search-federal-dockets.md): Finds federal RECAP dockets involving a named person or company, newest filed first. Only dockets in the RECAP Archive appear.
- [CourtListener API: Get court opinion](https://fous.com/methods/courtlistener.com/get-court-opinion.md): Finds a US court opinion on CourtListener by case name, citation, or opinion link, and returns its metadata, opinions, judges, citing-case count and the lead opinion's full text from its PDF.
- [Ballotpedia API: List ballot measures](https://fous.com/methods/ballotpedia.org/list-ballot-measures.md): Lists statewide ballot measures in a US state and year, in Ballotpedia order, with election dates, topics, measure types, yes/no vote meanings and results. Years without statewide measures return an empty list.
- [The National Archives API: Search judgments](https://fous.com/methods/caselaw.nationalarchives.gov.uk/search-judgments.md): Searches UK court judgments and tribunal decisions on Find Case Law by keywords or party names. Results can be filtered by court and by judgment date.
- [Stock Analysis API: List recent IPOs](https://fous.com/methods/stockanalysis.com/list-recent-ipos.md): Lists US IPOs from a chosen year, newest first. Each IPO comes with its IPO price, current price and return since IPO. Coverage begins in 2019.
- [Chess.com API: List recent games](https://fous.com/methods/chess.com/list-recent-games.md): Lists a Chess.com player's completed public games for a month, newest first, with results, ratings, opening and game links.
- [All Oyez methods](https://fous.com/methods/oyez.org.md)