SCOTUS case lookup with vote split (Oyez) API

Look up a Supreme Court case by term + docket via Oyez and get a compact decision card: parties, citation, lower court, granted/argued/decided dates, the question presented, holding, vote split (e.g. 6-3), winning party and decision type. Answers 'How did SCOTUS rule in docket 20-1199?', 'What was the vote split and who won?'.

Price$0.01per request

MethodPOST

Route/v1/gov/scotus-case

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache604800s public

govlegalscotussupreme-courtoyezcase-lawus

API URLhttps://x402.hexl.dev/v1/gov/scotus-case

Integration docs

Example request

{
  "term": 2022,
  "docket": "20-1199"
}

Example response

{
  "name": "Students for Fair Admissions v. President and Fellows of Harvard College",
  "docketNumber": "20-1199",
  "term": "2022",
  "citation": "600 U.S. ___ (2023)",
  "firstParty": "Students for Fair Admissions, Inc.",
  "secondParty": "President & Fellows of Harvard College",
  "mannerOfJurisdiction": "Writ of certiorari",
  "lowerCourt": "United States Court of Appeals for the First Circuit",
  "dateGranted": "2022-01-24",
  "dateArgued": "2022-10-31",
  "dateDecided": "2023-06-29",
  "decision": {
    "holding": "The Harvard admissions program violates the Equal Protection Clause of the Fourteenth Amendment.",
    "majorityVote": 6,
    "minorityVote": 2,
    "voteSplit": "6-2",
    "winningParty": "SFFA",
    "decisionType": "majority opinion"
  },
  "question": "May institutions of higher education use race as a factor in admissions? If so, does Harvard College’s race-conscious admissions process violate Title VI of the Civil Rights Act of 1964?",
  "justiaUrl": "https://supreme.justia.com/cases/federal/us/600/20-1199/",
  "disclaimer": "Informational data product aggregated from public government / open-legal APIs. NOT legal advice. Verify against the official primary source before relying on it."
}

Input schema

{
  "type": "object",
  "required": [
    "term",
    "docket"
  ],
  "properties": {
    "term": {
      "type": "integer",
      "minimum": 1789,
      "maximum": 2100,
      "description": "SCOTUS term year"
    },
    "docket": {
      "type": "string",
      "description": "Docket number e.g. '20-1199'"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}