# Oyez API: Get Supreme Court case > Finds an Oyez Supreme Court case by name or case link and returns its summary, decision, justice votes and argument audio links. Unofficial. Not affiliated with or endorsed by Oyez. - Page: https://fous.com/methods/oyez.org/get-supreme-court-case - Method: `oyez.org/get_supreme_court_case`, version 1 - Website: oyez.org - Returns: case name, docket number, term, citation, question, conclusion, decision, vote split, justice votes, argument audio links - 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 | |---|---|---|---|---| | `case` | string | yes | `"Brown v. Board of Education"` | Case name or Oyez case link, for example Brown v. Board of Education or https://www.oyez.org/cases/2021/19-1392. | | `term` | integer | no | | Supreme Court term year to choose between similar names, for example 1953. Omit to choose the closest matching case. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "case": "Brown v. Board of Education" } ``` Its output: ```json { "term": "1953", "citation": "347 U.S. 483 (1954)", "decision": "for Brown et al.", "question": "Does the segregation of public education based solely on race violate the Equal Protection Clause of the Fourteenth Amendment?", "case_name": "Brown v. Board of Education of Topeka (1)", "oyez_link": "https://www.oyez.org/cases/1940-1955/347us483", "conclusion": "Separate but equal educational facilities for racial minorities is inherently unequal, violating the Equal Protection Clause of the Fourteenth Amendment. Chief Justice Earl Warren delivered the opinion of the unanimous Court. The Supreme Court held that “separate but equal” facilities are inherently…", "vote_split": "9-0", "date_argued": "1952-12-09", "lower_court": "Federal district court", "date_decided": "1954-05-17", "docket_number": "1", "justice_votes": [ { "name": "Earl Warren", "vote": "majority" }, { "name": "Hugo L. Black", "vote": "majority" }, { "name": "Stanley Reed", "vote": "majority" } ], "facts_of_the_case": "This case was the consolidation of cases arising in Kansas, South Carolina, Virginia, Delaware, and Washington D.C. relating to the segregation of public schools on the basis of race. In each of the cases, African American students had been denied admittance to certain public schools based on laws a…", "argument_audio_links": [], "majority_opinion_author": "Earl Warren" } ``` ## 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/get_supreme_court_case","input":{"case":"Brown v. Board of Education"}}' ``` 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 - Can you pull up the Supreme Court case Brown v. Board of Education and tell me the vote split and who dissented? - I need the decision summary and justice votes for Miranda v. Arizona from the 1965 term. - Find the Oyez entry for https://www.oyez.org/cases/2021/19-1392 and list its docket number and conclusion. - What were the main question and the argument audio links for Loving v. Virginia? - Look up Roe v. Wade on oyez.org, the 1971 term version, and give me the citation and the justices' votes. ## Input schema ```json { "type": "object", "required": [ "case" ], "properties": { "case": { "type": "string", "description": "Case name or Oyez case link, for example Brown v. Board of Education or https://www.oyez.org/cases/2021/19-1392." }, "term": { "type": "integer", "description": "Supreme Court term year to choose between similar names, for example 1953. Omit to choose the closest matching case." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "case_name", "docket_number", "term", "citation", "facts_of_the_case", "question", "conclusion", "date_argued", "date_decided", "vote_split", "decision", "majority_opinion_author", "justice_votes", "lower_court", "argument_audio_links", "oyez_link" ], "properties": { "term": { "type": [ "string", "null" ] }, "citation": { "type": [ "string", "null" ] }, "decision": { "type": [ "string", "null" ] }, "question": { "type": [ "string", "null" ] }, "case_name": { "type": "string" }, "oyez_link": { "type": "string" }, "conclusion": { "type": [ "string", "null" ] }, "vote_split": { "type": [ "string", "null" ] }, "date_argued": { "type": [ "string", "null" ], "format": "date" }, "lower_court": { "type": [ "string", "null" ] }, "date_decided": { "type": [ "string", "null" ], "format": "date" }, "docket_number": { "type": [ "string", "null" ] }, "justice_votes": { "type": "array", "items": { "type": "object", "required": [ "name", "vote" ], "properties": { "name": { "type": "string" }, "vote": { "type": "string" } }, "additionalProperties": false } }, "facts_of_the_case": { "type": [ "string", "null" ] }, "argument_audio_links": { "type": "array", "items": { "type": "string" } }, "majority_opinion_author": { "type": [ "string", "null" ] } }, "additionalProperties": false } ``` ## See more - [Oyez API: List term cases](https://fous.com/methods/oyez.org/list-term-cases.md): 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. - [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. - [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. - [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. - [Congress.gov API: Get bill](https://fous.com/methods/congress.gov/get-bill.md): Gets the status, official summary, titles, actions and related bills for one U.S. bill on Congress.gov, found by popular name, title, number or link. A missing summary or text is returned as null. - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series. - [USPTO API: Search US trademarks](https://fous.com/methods/uspto.gov/search-trademarks.md): Finds US trademark filings matching a brand name, optionally limited to likely goods or service classes. Exact marks come first, similar marks follow; not a legal clearance opinion. - [All Oyez methods](https://fous.com/methods/oyez.org.md)