{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/metricduck-com/json-schema/metricduck-com-cash-flow-quality-item-schema.json",
  "title": "CashFlowQualityItem",
  "description": "Factual cash-flow-quality metrics for a single period.\n\nFive logical sections:\n1. Cash Generation Performance\n2. Capital Investment Requirements\n3. Free Cash Flow (Core)\n4. Growth & Reinvestment Analysis\n5. Balance Sheet Adjustments",
  "x-generated": "2026-11-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/metricduck-com-openapi.json#/components/schemas/CashFlowQualityItem",
  "properties": {
    "price_attribution": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Attribution",
      "description": "The price source's required attribution, present only when the prices in this response come from a source that requires one (IEX HIST)."
    },
    "cik": {
      "type": "string",
      "title": "Cik"
    },
    "accession_number": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Accession Number"
    },
    "date": {
      "type": "string",
      "title": "Date"
    },
    "symbol": {
      "type": "string",
      "title": "Symbol"
    },
    "filing_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Filing Date"
    },
    "fiscal_year": {
      "type": "integer",
      "title": "Fiscal Year"
    },
    "period": {
      "type": "string",
      "title": "Period"
    },
    "market_price": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Market Price"
    },
    "market_price_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Market Price Date"
    },
    "industry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Industry"
    },
    "sector": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sector"
    },
    "sic_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sic Code"
    },
    "net_cf_ops": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Net Cf Ops"
    },
    "net_cf_ops_margin": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Net Cf Ops Margin"
    },
    "net_cf_ops_yoy": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Net Cf Ops Yoy"
    },
    "ocf_volatility_8q": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ocf Volatility 8Q"
    },
    "ocf_consistency_score": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ocf Consistency Score"
    },
    "ocf_to_net_income_ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ocf To Net Income Ratio"
    },
    "revenues": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Revenues"
    },
    "net_income": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Net Income"
    },
    "chg_working_cap": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Chg Working Cap"
    },
    "capex": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capex"
    },
    "capex_intensity": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capex Intensity"
    },
    "capex_yoy": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capex Yoy"
    },
    "capex_to_depreciation_ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capex To Depreciation Ratio"
    },
    "capex_volatility_8q": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capex Volatility 8Q"
    },
    "avg_capex_3y": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Avg Capex 3Y"
    },
    "deprec_amort": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Deprec Amort"
    },
    "ppe": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ppe"
    },
    "ppe_turnover": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ppe Turnover"
    },
    "fcf": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf"
    },
    "ufcf": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ufcf"
    },
    "fcf_equity": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Equity"
    },
    "fcf_margin": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Margin"
    },
    "fcf_yield": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Yield"
    },
    "fcf_conversion_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Conversion Rate"
    },
    "fcf_yoy": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Yoy"
    },
    "fcf_cagr_3y": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Cagr 3Y"
    },
    "fcf_growth_stability": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Growth Stability"
    },
    "fcf_volatility_8q": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Volatility 8Q"
    },
    "fcf_positive_periods": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Positive Periods"
    },
    "fcf_min_max_range_8q": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Min Max Range 8Q"
    },
    "fcf_consistency_score": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf Consistency Score"
    },
    "revenue_growth_yoy": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Revenue Growth Yoy"
    },
    "revenue_cagr_3y": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Revenue Cagr 3Y"
    },
    "fcf_to_revenue_growth_correlation": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fcf To Revenue Growth Correlation"
    },
    "reinvestment_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reinvestment Rate"
    },
    "incremental_roic": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Incremental Roic"
    },
    "growth_efficiency_score": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Growth Efficiency Score"
    },
    "sustainable_growth_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sustainable Growth Rate"
    },
    "implied_fcf_growth": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Implied Fcf Growth"
    },
    "st_debt": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "St Debt"
    },
    "lt_debt": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lt Debt"
    },
    "debt_yoy_change": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Debt Yoy Change"
    },
    "cash_st_invs": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cash St Invs"
    },
    "excess_cash": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Excess Cash"
    },
    "net_debt": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Net Debt"
    },
    "shares_outstanding_basic": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Shares Outstanding Basic"
    },
    "shares_outstanding_diluted": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Shares Outstanding Diluted"
    },
    "share_count_trend_3y": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Share Count Trend 3Y"
    },
    "current_market_cap": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Current Market Cap"
    },
    "implied_fcf_yield_current": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Implied Fcf Yield Current"
    },
    "historical_fcf_yield_avg_5y": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Historical Fcf Yield Avg 5Y"
    },
    "sec_filing_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sec Filing Url",
      "description": "Generate SEC EDGAR filing index URL.\n\nReturns:\n    URL string if accession_number exists, None otherwise",
      "readOnly": true
    }
  },
  "type": "object",
  "required": [
    "cik",
    "date",
    "symbol",
    "fiscal_year",
    "period",
    "sec_filing_url"
  ]
}