MetricDuck Cash Flow Quality API
The Cash Flow Quality API from MetricDuck — 1 operation(s) for cash flow quality.
The Cash Flow Quality API from MetricDuck — 1 operation(s) for cash flow quality.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-cash-flow-quality-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Metric Duck Cash Flow Quality API
description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
version: 2.0.0
tags:
- name: Cash Flow Quality
paths:
/api/v1/companies/{ticker}/cash-flow-quality:
get:
tags:
- Cash Flow Quality
summary: Get factual cash-flow-quality metrics
description: 'Returns computed cash-flow-quality metrics per period: FCF history, capex
normalization, 8Q volatility, OCF/FCF reconciliation, growth, balance-sheet
adjustments. Factual data only — no WACC, no intrinsic-value estimates.
**Sister endpoint:** `/companies/{ticker}/cash-flow` returns raw statement
line items. This endpoint returns the computed metrics derived from them.
**Data Source:** SEC EDGAR (10-K, 10-Q filings) via `filing_metrics` BQ table'
operationId: get_cash_flow_quality_api_v1_companies__ticker__cash_flow_quality_get
deprecated: true
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
description: Company ticker (e.g., 'AAPL')
title: Ticker
description: Company ticker (e.g., 'AAPL')
- name: period
in: query
required: false
schema:
type: string
pattern: ^(quarterly|annual|ttm)$
description: '''quarterly'', ''annual'', or ''ttm'''
default: quarterly
title: Period
description: '''quarterly'', ''annual'', or ''ttm'''
- name: years
in: query
required: false
schema:
type: integer
maximum: 10
minimum: 1
description: Years of history (1-10)
default: 5
title: Years
description: Years of history (1-10)
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CashFlowQualityItem'
title: Response 200 Get Cash Flow Quality Api V1 Companies Ticker Cash Flow Quality Get
'400':
description: Bad Request — invalid ticker / period / years
'404':
description: Ticker not found or no data for requested period
'429':
description: Rate limit exceeded
'500':
description: Server error
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
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
title: CashFlowQualityItem
description: 'Factual cash-flow-quality metrics for a single period.
Five logical sections:
1. Cash Generation Performance
2. Capital Investment Requirements
3. Free Cash Flow (Core)
4. Growth & Reinvestment Analysis
5. Balance Sheet Adjustments'
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key