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.

Body
required
application/json
  • citations
    Type: array string[]

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

  • docket
    Type: object · DocketLookup

    Lookup by docket number and court. Requires docket_number and either court_id or court_abbreviation.

  • include_content
    Type: boolean

    Include full HTML content

  • include_detailed_treatments
    Type: boolean

    Include citator treatments

  • opinion_ids
    Type: array string[]

    Array of opinion IDs to retrieve

Responses
  • application/json
  • application/json
Request Example for post/opinions/get
curl http://app.midpage.ai/api/v1/opinions/get \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "opinion_ids": [
    "8623588",
    "1865773"
  ],
  "citations": [
    "556 U.S. 662",
    "550 U.S. 544"
  ],
  "docket": {
    "docket_number": "19-1392",
    "court_id": "scotus",
    "court_abbreviation": "SCOTUS"
  },
  "include_content": false,
  "include_detailed_treatments": false
}'

{
  "opinions": [
    {
      "id": "472185",
      "case_name": "United States v. Jorge Arroyo, A/K/A Sergio",
      "court_id": "ca5",
      "court_abbreviation": "5th Cir.",
      "docket_number": "85-2605",
      "date_filed": "1986-07-16",
      "state": "Federal",
      "judge_name": "Davis",
      "citations": [
        {
          "cited_as": "794 F.2d 208",
          "volume": "794",
          "reporter": "F.2d",
          "page": "208"
        },
        {
          "cited_as": "1986 U.S. App. LEXIS 36887",
          "volume": "1986",
          "reporter": "U.S. App. LEXIS",
          "page": "36887"
        }
      ],
      "citation_count": 1,
      "overall_treatment": "Neutral"
    }
  ]
}

Opinion data