Institutional Ownership by Ticker

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker symbol (e.g. 'AAPL')."
    },
    "exchange": {
      "type": "string",
      "description": "Stock exchange (e.g. 'NYSE', 'NASDAQ')."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "details": {
                "type": "string",
                "description": "Observed as an empty string on every real row captured; its populated shape is unconfirmed."
              },
              "sharesHeld": {
                "type": "string",
                "description": "Formatted share count, e.g. '31,079' or '70,758,208'."
              },
              "marketValue": {
                "type": "string",
                "description": "Formatted USD position value, e.g. '$9.07M', '$20.47B'."
              },
              "reportingDate": {
                "type": "string",
                "description": "e.g. '9/3/2026' (M/D/YYYY, no leading zeros). On a filler row (see this array's own description) this field instead holds unrelated promotional text."
              },
              "shareholderName": {
                "type": "string",
                "description": "The reporting institution's or individual filer's name, e.g. 'Anchor Capital Advisors LLC', 'Saudi Central Bank'. Absent on filler rows and on an invalid-ticker call."
              },
              "ownershipInCompany": {
                "type": "string",
                "description": "Percent of the company's total outstanding shares this holder owns, e.g. '0.485%'."
              },
              "percentOfPortfolio": {
                "type": "string",
                "description": "Percent of the holder's own portfolio this position represents, e.g. '0.2%'."
              },
              "quarterlyChangeInShares": {
                "type": "string",
                "description": "Percent change in shares held since the prior quarter, e.g. '+7.6%', or the literal string 'N/A' when unavailable."
              }
            },
            "additionalProperties": false
          },
          "description": "Rows of institutional holders for the requested ticker, most recent reporting date first, on the one real call for a valid ticker (AAPL) observed. Confirmed against a second real call: an unrecognized/invalid ticker does NOT return an error or an empty list -- it returns this same items[] array populated with a completely different, unrelated dataset (a generic top-companies-by-market-cap list, not scoped to the requested ticker and not ownership data at all), so a row only reliably holds a real institutional-holder record when it has a shareholderName. Also confirmed on the valid-ticker call: a small number of rows are promotional/newsletter filler text the upstream provider embeds in the array, not real data -- a filler row typically has only reportingDate present, holding ad copy rather than a date, and no shareholderName."
        }
      },
      "additionalProperties": false
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed, including the invalid-ticker call."
    }
  },
  "description": "The institutional-ownership record for the requested ticker, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}