# Oyez Supreme Court API > The US Supreme Court as an API, powered by Oyez — clean JSON, no key. Browse cases by term and open any case for its full detail: the parties, the facts, the legal question, the conclusion, a dated timeline, the lower court, and the decision with each justice's individual vote and opinion. Pull the oral-argument transcript for a case — every speaker turn with start/stop timestamps and a link to the audio — ideal for analysis, search and captioning. List all the justices and open a justice's profile (dates, places, seats held). Live data straight from oyez.org, the definitive multimedia archive of the Supreme Court. Distinct, authoritative civic data — ideal for legal-tech, research, education, news and civic apps. 5 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/oyez-api/..." ``` ## Pricing - **Free** (Free) — 3,000 calls/Mo, 5 req/s - **Starter** ($8/Mo) — 48,000 calls/Mo, 15 req/s - **Pro** ($32/Mo) — 290,000 calls/Mo, 30 req/s - **Mega** ($95/Mo) — 1,250,000 calls/Mo, 80 req/s ## Endpoints ### Cases #### `GET /v1/case` — Case detail (decision + votes) **Parameters:** - `term` (query, required, string) — Term (year) Example: `2008` - `docket` (query, required, string) — Docket number Example: `08-205` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/case?term=2008&docket=08-205" ``` **Response:** ```json { "data": { "case": { "id": 55589, "href": "https://api.oyez.org/cases/2008/08-205", "name": "Citizens United v. Federal Election Commission", "term": "2008", "facts": "Citizens United sought an injunction against the Federal Election Commission in the United States District Court for the District of Columbia to prevent the application of the Bipartisan Campaign Reform Act (BCRA) to its film Hillary: The Movie. The Movie expressed opinions about whether Senator Hillary Rodham Clinton would make a good president.\nIn an attempt to regulate \"big money\" campaign contributions, the BCRA applies a variety of restrictions to \"electioneering communications.\" Section 203 of the BCRA prevents corporations or labor unions from funding such communication from their general treasuries. Sections 201 and 311 require the disclosure of donors to such communication and a disclaimer when the communication is not authorized by the candidate it intends to support.\nCitizens United argued that: 1) Section 203 violates the First Amendment on its face and when applied to The Movie and its related advertisements, and that 2) Sections 201 and 203 are also unconstitutional as applied to the circumstances.\nThe United States District Court denied the injunction. Section 203 on its face was not unconstitutional because the Supreme Court in McConnell v. FEC had already reached that determination. The District Court also held that …(truncated, see openapi.json for full schema) ``` #### `GET /v1/case/oral-argument` — Oral-argument transcript **Parameters:** - `term` (query, required, string) — Term (year) Example: `2008` - `docket` (query, required, string) — Docket number Example: `08-205` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/case/oral-argument?term=2008&docket=08-205" ``` **Response:** ```json { "data": { "case": "Citizens United v. Federal Election Commission", "term": "2008", "title": "Oral Argument - March 24, 2009", "turns": [ { "stop": 8.119, "text": "We will hear argument today in Case 08-205, Citizens United v. The Federal Election Commission. Mr. Olson.", "start": 0, "speaker": "John G. Roberts, Jr." }, { "stop": 130.319, "text": "Mr. Chief Justice, and may it please the Court: Participation in the political process is the First Amendment's most fundamental guarantee. Yet that freedom is being smothered by one of the most complicated, expensive, and incomprehensible regulatory regimes ever invented by the administrative state. In the case that you consider today, it is a felony for a small, nonprofit corporation to offer interested viewers a 90-minute political documentary about a candidate for the nation's highest office that General Electric, National Public Radio, or George Soros may freely broadcast. Its film may be shown in theaters, sold on DVDs, transmitted for downloading on the Internet, and its message may be distributed in the form of a book. But its producers face 5 years in prison if they offer it in the home through the vehicle of Video On Demand. Because the limitation on speech, political speech, is at the core of the First Amendment, the government has a heavy burden to estab …(truncated, see openapi.json for full schema) ``` #### `GET /v1/cases` — Browse cases by term **Parameters:** - `term` (query, optional, string) — Supreme Court term (year) Example: `2008` - `page` (query, optional, string) — Page (0-based) Example: `0` - `per_page` (query, optional, string) — Results per page (1–100) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/cases?term=2008&page=0&per_page=25" ``` **Response:** ```json { "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, "descrip …(truncated, see openapi.json for full schema) ``` ### Justices #### `GET /v1/justice` — Justice profile by id **Parameters:** - `id` (query, required, string) — Justice id (slug) Example: `ketanji_brown_jackson` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/justice?id=ketanji_brown_jackson" ``` **Response:** ```json { "data": { "justice": { "id": "ketanji_brown_jackson", "href": "https://api.oyez.org/people/ketanji_brown_jackson", "name": "Ketanji Brown Jackson", "roles": [ { "type": "scotus_justice", "date_end": null, "date_start": "2022-06-30", "role_title": "Associate Justice of the Supreme Court of the United States", "institution": "Supreme Court of the United States" } ], "last_name": "Jackson", "first_name": "Ketanji", "view_count": 0, "name_suffix": null, "date_of_birth": 22136400, "date_of_death": 0, "place_of_birth": "Washington, DC", "place_of_death": null } }, "meta": { "timestamp": "2026-06-07T16:46:56.825Z", "request_id": "c0c85c26-829f-4524-9b09-92e12afe9089" }, "status": "ok", "message": "Justice retrieved successfully", "success": true } ``` #### `GET /v1/justices` — All justices **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/justices" ``` **Response:** ```json { "data": { "count": 30, "justices": [ { "id": "ketanji_brown_jackson", "href": "https://api.oyez.org/people/ketanji_brown_jackson", "name": "Ketanji Brown Jackson", "last_name": "Jackson", "view_count": 0 }, { "id": "amy_coney_barrett", "href": "https://api.oyez.org/people/amy_coney_barrett", "name": "Amy Coney Barrett", "last_name": "Barrett", "view_count": 0 }, { "id": "brett_m_kavanaugh", "href": "https://api.oyez.org/people/brett_m_kavanaugh", "name": "Brett M. Kavanaugh", "last_name": "Kavanaugh", "view_count": 0 }, { "id": "neil_gorsuch", "href": "https://api.oyez.org/people/neil_gorsuch", "name": "Neil Gorsuch", "last_name": "Gorsuch", "view_count": 0 }, { "id": "elena_kagan", "href": "https://api.oyez.org/people/elena_kagan", "name": "Elena Kagan", "last_name": "Kagan", "view_count": 0 }, { "id": "sonia_sotomayor", "href": "https://api.oyez.org/people/sonia_sotomayor", "name": " …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/oyez-api/v1/meta" ``` **Response:** ```json { "data": { "service": "oyez-api", "endpoints": { "GET /v1/case": "Full case detail by term + docket.", "GET /v1/meta": "This document.", "GET /v1/cases": "Browse cases (term=, page=).", "GET /v1/justice": "A justice's profile by id.", "GET /v1/justices": "All Supreme Court justices.", "GET /v1/case/oral-argument": "Oral-argument transcript (speaker turns + audio) by term + docket." }, "description": "Oyez: US Supreme Court cases — browse by term, full case detail (parties, facts, question, conclusion, timeline, the decision with each justice's vote, advocates), oral-argument transcripts with speaker turns and audio, and justice profiles. Real live data, no key." }, "meta": { "timestamp": "2026-06-07T16:46:57.140Z", "request_id": "a74f9bb1-85d6-4fe5-99ae-00bd8e156cdb" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/oyez-api OpenAPI spec: https://www.oanor.com/api/oyez-api/openapi.json