{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ai-law-tracker-com/json-schema/ai-law-tracker-com-court-opinion-schema.json",
  "title": "CourtOpinion",
  "description": "One published court opinion, IDENTIFIED but not reproduced. The record carries the case name, court, filing date, docket number, reporter citation and how many later opinions cite it; the decision itself lives at absolute_url. There is no opinion text and no holding in this corpus.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ai-law-tracker-com-openapi.json#/components/schemas/CourtOpinion",
  "type": "object",
  "properties": {
    "cluster_id": {
      "type": "integer",
      "description": "CourtListener cluster id — the stable identifier, and the path parameter of the detail endpoint."
    },
    "case_name": {
      "type": "string",
      "description": "The caption. This is the ONLY field `q` searches. Never withheld at any tier."
    },
    "court_id": {
      "type": "string",
      "description": "Court slug, e.g. scotus, iowa, nyappdiv. See /us-law/courts for the full list."
    },
    "court_name": {
      "type": "string",
      "description": "Never withheld at any tier."
    },
    "court_citation_string": {
      "type": [
        "string",
        "null"
      ],
      "description": "The court’s reporter abbreviation, e.g. \"Iowa\". Withheld in the trimmed (basic) envelope."
    },
    "court_jurisdiction": {
      "type": "string",
      "enum": [
        "F",
        "S",
        "SA"
      ],
      "description": "The indexed jurisdiction code the court_level / jurisdiction_level filters resolve onto."
    },
    "court_level": {
      "type": "string",
      "enum": [
        "federal_appellate",
        "state_supreme",
        "state_appellate"
      ]
    },
    "date_filed": {
      "type": "string",
      "format": "date",
      "description": "ALWAYS read alongside date_filed_is_approximate."
    },
    "date_filed_is_approximate": {
      "type": "boolean",
      "description": "True when the filing date is our source’s approximation rather than a stated date — 58,828 of 988,554 records. NEVER withheld at any tier, including the keyless envelope: shipping date_filed without this flag would present a guess as a fact to people who compute deadlines from it."
    },
    "precedential_status": {
      "type": "string",
      "description": "Every record currently held is \"Published\"."
    },
    "docket_id": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Withheld in the trimmed (basic) envelope."
    },
    "docket_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Withheld in the trimmed (basic) envelope. NOT a filter — see the endpoint description."
    },
    "primary_citation": {
      "type": [
        "string",
        "null"
      ],
      "description": "Reporter citation, e.g. \"2022 OK 38\". 541,629 of 988,554 records carry one. Never withheld at any tier."
    },
    "citation_count": {
      "type": "integer",
      "description": "How many later opinions cite this one. Withheld in the trimmed (basic) envelope."
    },
    "absolute_url": {
      "type": "string",
      "description": "Where the decision itself is. Never withheld at any tier — it is how you check our work."
    },
    "slug": {
      "type": [
        "string",
        "null"
      ],
      "description": "Withheld in the trimmed (basic) envelope."
    },
    "source_authority": {
      "type": "string",
      "description": "courtlistener. Withheld in the trimmed (basic) envelope."
    },
    "bulk_edition": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Which source bulk edition this row came from. Withheld in the trimmed (basic) envelope."
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time",
      "description": "When WE fetched it — not when the court decided it. Withheld in the trimmed (basic) envelope."
    }
  }
}