Stock Dividend History & Yield (by Symbol)

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Stock symbol (e.g. AAPL)."
    },
    "asset_class": {
      "type": "string",
      "description": "Asset class: stocks, etf, mutualfunds."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "message": {
          "type": [
            "string",
            "null"
          ],
          "description": "Null on a normal Nasdaq-listed symbol (aapl-dividend-history.json). A short explanatory string, e.g. 'Dividend History for Non-Nasdaq symbols is not available', on a symbol the endpoint has no dividend data for (observed on the SPY ETF) -- read this before trusting the 'N/A' fields below."
        },
        "dividend": {
          "type": "object",
          "properties": {
            "yield": {
              "type": "string",
              "description": "Formatted percentage string, e.g. '0.32%', or 'N/A'."
            },
            "history": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Observed as null on every real call made so far, both fixtures."
                },
                "rows": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "e.g. 'Cash', the only value observed."
                      },
                      "amount": {
                        "type": "string",
                        "description": "Formatted currency string, e.g. '$0.27'."
                      },
                      "currency": {
                        "type": "string",
                        "description": "ISO currency code, e.g. 'USD'."
                      },
                      "recordDate": {
                        "type": "string",
                        "description": "e.g. '08/10/2026'."
                      },
                      "exOrEffDate": {
                        "type": "string",
                        "description": "e.g. '08/10/2026'."
                      },
                      "paymentDate": {
                        "type": "string",
                        "description": "e.g. '08/13/2026', or 'N/A' on older rows."
                      },
                      "declarationDate": {
                        "type": "string",
                        "description": "e.g. '07/30/2026', or 'N/A' on older rows."
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "One entry per historical dividend payment, most recent first. 84 entries observed on a real Nasdaq-listed stock going back to 1988; absent when the symbol has no dividend history."
                }
              },
              "description": "Absent/empty when the endpoint has no dividend data for the symbol (observed on the SPY ETF, where the raw `dividends.rows` value is null rather than an array) -- not an error condition, see `data.message`.",
              "additionalProperties": true
            },
            "payoutRatio": {
              "type": "string",
              "description": "Formatted numeric string, e.g. '55.07', or 'N/A'."
            },
            "headerValues": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "value": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "description": "A 4-entry display summary on every real call observed: Ex-Dividend Date, Dividend Yield, Annual Dividend, and P/E Ratio. The first three duplicate the scalar fields above; P/E Ratio is not available anywhere else in this response. All four values come back as the literal string 'N/A' on a symbol with no dividend data."
            },
            "exDividendDate": {
              "type": "string",
              "description": "e.g. '08/10/2026', or the literal string 'N/A' when unavailable."
            },
            "annualizedDividend": {
              "type": "string",
              "description": "Formatted numeric string, e.g. '1.08', or 'N/A'."
            },
            "dividendPaymentDate": {
              "type": "string",
              "description": "e.g. '08/13/2026', or the literal string 'N/A' when unavailable."
            }
          },
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both fixtures observed."
    }
  },
  "description": "The dividend record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}