Sign in

v2

latestOpenAPI 3.1.02026-07-2662567.7 KB

Get opinions

Retrieve full opinion data by ID, citation, or docket number. Supports bulk reads of up to 100 items per request.

Provide exactly one of opinion_ids, citations, or docket (not multiple).

Lookup methods:

  • opinion_ids - Direct lookup by opinion ID (up to 100)
  • citations - Lookup by reporter citation, case-insensitive (up to 100)
  • docket - Lookup by docket number + court (single lookup, may return multiple opinions)

When using citations or docket, a lookup may match multiple opinions (e.g., majority and dissent from the same case). The response includes citation_matches or docket_matches arrays showing which lookups matched which opinion IDs.

post/opinions/get

Request body

opinion_idsstring[]

Array of opinion IDs to retrieve

citationsstring[]

Array of citation strings to look up (case-insensitive)

include_contentboolean

Include full HTML content

include_detailed_treatmentsboolean

Include citator treatments

Example request

{
  "opinion_ids": [
    "8623588",
    "1865773"
  ],
  "citations": [
    "556 U.S. 662",
    "550 U.S. 544"
  ],
  "docket": {
    "docket_number": "19-1392",
    "court_id": "scotus",
    "court_abbreviation": "SCOTUS"
  }
}

Response

Opinion data

Example response

{
  "citation_matches": [
    {
      "citation": "556 U.S. 662",
      "opinion_id": "145875"
    }
  ],
  "docket_matches": [
    {
      "docket_number": "19-1392",
      "court_id": "scotus",
      "court_abbreviation": "SCOTUS",
      "opinion_id": "145875"
    }
  ]
}